Open
Conversation
- /dotnet/framework/interop/com-callable-wrapper -> /dotnet/standard/native-interop/com-callable-wrapper - /dotnet/framework/interop/runtime-callable-wrapper -> /dotnet/standard/native-interop/runtime-callable-wrapper - /dotnet/framework/misc/using-the-assert-method -> /previous-versions/dotnet/framework/code-access-security/using-the-assert-method Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Update links across core, standard, framework, fundamentals, and csharp categories to their current redirect destinations. Key changes: - C# keywords/operators moved to new language-reference paths - C# LINQ docs moved from programming-guide to linq/ - Framework link-demands and assert moved to previous-versions - Framework interop docs moved to standard/native-interop - Standard parallel-linq-plinq renamed to introduction-to-plinq - Standard threading/ redirects to threading/managed-threading-basics - Fundamentals apicompat and networking path updates Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates .NET API reference documentation to replace redirected /dotnet/... links with newer target URLs, as preparation for #10722’s broader reconciliation work.
Changes:
- Updates many
<related>and inline documentation links to newer Learn URL paths (C#, threading, reflection, PLINQ, interop, etc.). - Replaces “supplemental remarks” links with inlined markdown remarks for some LINQ-to-SQL types.
- Adds new snippet projects/files for
System.Data.Linq.TableAttribute(C# and Visual Basic).
Reviewed changes
Copilot reviewed 128 out of 129 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| xml/System/UIntPtr.xml | Updates C# nuint documentation link. |
| xml/System/Type.xml | Updates reflection article links. |
| xml/System/ThreadStaticAttribute.xml | Updates threading article link. |
| xml/System/String.xml | Updates foreach documentation link. |
| xml/System/Span`1+Enumerator.xml | Updates foreach and ref struct documentation links. |
| xml/System/ReadOnlySpan`1+Enumerator.xml | Updates foreach documentation link. |
| xml/System/Nullable`1.xml | Updates default documentation link. |
| xml/System/NullReferenceException.xml | Updates operator and nullable-reference-types links. |
| xml/System/MathF.xml | Updates remainder operator documentation link. |
| xml/System/Math.xml | Updates remainder operator documentation links. |
| xml/System/IntPtr.xml | Updates C# nint documentation link. |
| xml/System/IndexOutOfRangeException.xml | Updates foreach documentation link. |
| xml/System/Func`5.xml | Updates anonymous method / lambda expression links. |
| xml/System/Func`4.xml | Updates anonymous method / lambda expression links. |
| xml/System/Func`3.xml | Updates anonymous method / lambda expression links. |
| xml/System/Func`2.xml | Updates anonymous method / lambda expression links. |
| xml/System/Func`1.xml | Updates anonymous method / lambda expression links. |
| xml/System/DuplicateWaitObjectException.xml | Updates threading article link. |
| xml/System/ArraySegment`1+Enumerator.xml | Updates foreach documentation link. |
| xml/System/ArgumentOutOfRangeException.xml | Updates threading + lock statement documentation links. |
| xml/System/AppDomainManager.xml | Adjusts IMPORTANT/NOTE formatting and removes Link Demands link. |
| xml/System/AggregateException.xml | Updates PLINQ article link. |
| xml/System/Action`4.xml | Updates anonymous method / lambda expression links. |
| xml/System/Action`3.xml | Updates anonymous method / lambda expression links. |
| xml/System/Action`2.xml | Updates anonymous method / lambda expression links. |
| xml/System/Action`1.xml | Updates anonymous method / lambda expression links. |
| xml/System/Action.xml | Updates anonymous method / lambda expression links. |
| xml/System.Xml/XmlWriterSettings.xml | Updates async programming article link. |
| xml/System.Xml/XmlResolver.xml | Updates async programming article link. |
| xml/System.Xml/XmlReaderSettings.xml | Updates async programming article link. |
| xml/System.Xml/XmlReader.xml | Updates async programming article links. |
| xml/System.Xml/XmlDictionaryWriter.xml | Updates async programming article links. |
| xml/System.Xml.Xsl/XsltArgumentList.xml | Updates params documentation link. |
| xml/System.Xml.Xsl/XslTransform.xml | Updates params documentation link. |
| xml/System.Xml.Linq/XElement.xml | Updates XElement overview links (standard LINQ). |
| xml/System.Windows.Shell/JumpList.xml | Updates Link Demands link to previous-versions URL. |
| xml/System.Windows.Input/TouchDevice.xml | Updates Link Demands link to previous-versions URL. |
| xml/System.Windows.Controls/ItemContainerGenerator.xml | Updates using statement article link. |
| xml/System.Windows.Annotations.Storage/AnnotationStore.xml | Updates lock statement article link. |
| xml/System.Threading/WaitHandle.xml | Updates threading-related article links. |
| xml/System.Threading/Semaphore.xml | Updates threading-related article links. |
| xml/System.Threading/ReaderWriterLock.xml | Updates threading-related article links. |
| xml/System.Threading/Mutex.xml | Updates threading-related article links. |
| xml/System.Threading/Monitor.xml | Updates threading-related article links. |
| xml/System.Threading/ManualResetEvent.xml | Updates synchronization primitives article links. |
| xml/System.Threading/LockCookie.xml | Updates reader-writer locks article links. |
| xml/System.Threading/Interlocked.xml | Updates synchronization primitives article links. |
| xml/System.Threading/EventWaitHandle.xml | Updates synchronization primitives article links. |
| xml/System.Threading/AutoResetEvent.xml | Updates synchronization primitives article links. |
| xml/System.Security/SecurityException.xml | Updates C# is operator documentation links. |
| xml/System.Security.Permissions/SecurityAction.xml | Removes framework-specific Assert Method link from summary. |
| xml/System.Security.Permissions/HostProtectionAttribute.xml | Removes Link Demands related link. |
| xml/System.Security.Cryptography/CryptoStream.xml | Updates async programming article links. |
| xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml | Updates Preview APIs article link. |
| xml/System.Runtime.Serialization/FormatterServices.xml | Removes Link Demands link from remarks text. |
| xml/System.Runtime.Remoting/SoapServices.xml | Removes Link Demands link and extra blank lines. |
| xml/System.Runtime.Remoting/ObjRef.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Services/TrackingServices.xml | Normalizes markdown formatting and removes Link Demands link. |
| xml/System.Runtime.Remoting.Services/ITrackingHandler.xml | Normalizes markdown formatting and removes Link Demands link. |
| xml/System.Runtime.Remoting.Services/EnterpriseServicesHelper.xml | Updates COM callable wrapper link and edits Link Demands note text. |
| xml/System.Runtime.Remoting.Proxies/RealProxy.xml | Removes Link Demands link and updates COM callable wrapper link. |
| xml/System.Runtime.Remoting.Proxies/ProxyAttribute.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Messaging/ReturnMessage.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Messaging/LogicalCallContext.xml | Removes Link Demands link and extra blank lines. |
| xml/System.Runtime.Remoting.Messaging/CallContext.xml | Removes Link Demands link and extra blank lines. |
| xml/System.Runtime.Remoting.Lifetime/LifetimeServices.xml | Removes Link Demands link and extra blank lines. |
| xml/System.Runtime.Remoting.Lifetime/ClientSponsor.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/TransportHeaders.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/ChannelDataStore.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/BaseChannelWithProperties.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/BaseChannelSinkWithProperties.xml | Removes Link Demands link. |
| xml/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml | Removes Link Demands link. |
| xml/System.Runtime.InteropServices/Marshal.xml | Updates COM callable/runtime callable wrapper links to standard interop docs. |
| xml/System.Runtime.CompilerServices/AsyncStateMachineAttribute.xml | Updates async + typeof links. |
| xml/System.Reflection/MethodInfo.xml | Updates generics article link. |
| xml/System.Reflection/MethodImplAttributes.xml | Updates lock statement link. |
| xml/System.Reflection/AssemblyName.xml | Updates reflection article links. |
| xml/System.Reflection/Assembly.xml | Updates reflection article link. |
| xml/System.Net.Http/HttpClient.xml | Updates HttpClient guidelines article link. |
| xml/System.Linq/ParallelQuery`1.xml | Updates PLINQ article link. |
| xml/System.Linq/ParallelQuery.xml | Updates PLINQ article link. |
| xml/System.Linq/ParallelMergeOptions.xml | Updates PLINQ article link. |
| xml/System.Linq/ParallelExecutionMode.xml | Updates PLINQ article link. |
| xml/System.Linq/OrderedParallelQuery`1.xml | Updates PLINQ article link. |
| xml/System.Linq/Enumerable.xml | Updates many LINQ programming guide links to newer LINQ docs. |
| xml/System.Linq.Expressions/Expression`1.xml | Updates lambda expressions article link. |
| xml/System.IO/File.xml | Updates LINQ-to-Objects link. |
| xml/System.Dynamic/DynamicObject.xml | Updates dynamic keyword article link. |
| xml/System.Diagnostics/ProcessStartInfo.xml | Removes Link Demands link. |
| xml/System.Diagnostics/Process.xml | Removes Link Demands link. |
| xml/System.Diagnostics/FileVersionInfo.xml | Removes Link Demands link and extra blank lines. |
| xml/System.Diagnostics/Debug.xml | Updates params keyword link. |
| xml/System.Diagnostics.Tracing/EventSource.xml | Updates /unsafe compiler option link. |
| xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml | Updates Preview APIs article link. |
| xml/System.Data/TypedTableBaseExtensions.xml | Updates standard query operators article link. |
| xml/System.Data/EnumerableRowCollectionExtensions.xml | Updates standard query operators article link. |
| xml/System.Data.Linq/DataLoadOptions.xml | Replaces supplemental link with inlined markdown remarks. |
| xml/System.Data.Linq.Mapping/TableAttribute.xml | Replaces supplemental link with inlined markdown remarks and adds snippet references. |
| xml/System.Collections/DictionaryEntry.xml | Updates foreach documentation link. |
| xml/System.Collections/DictionaryBase.xml | Updates foreach documentation link. |
| xml/System.Collections.Generic/IEnumerable`1.xml | Updates yield keyword documentation link. |
| xml/System.CodeDom/CodeTypeParameter.xml | Updates generics article link. |
| xml/System.CodeDom/CodeTypeDeclaration.xml | Updates generics article link. |
| xml/System.CodeDom/CodeDefaultValueExpression.xml | Updates generics article link. |
| xml/System.CodeDom.Compiler/TempFileCollection.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/IndentedTextWriter.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/Executor.xml | Normalizes markdown formatting and removes Link Demands link. |
| xml/System.CodeDom.Compiler/CompilerParameters.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/CompilerInfo.xml | Removes Link Demands link and extra blank lines. |
| xml/System.CodeDom.Compiler/CodeParser.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/CodeGeneratorOptions.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/CodeGenerator.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/CodeDomProvider.xml | Removes Link Demands link. |
| xml/System.CodeDom.Compiler/CodeCompiler.xml | Removes Link Demands link. |
| xml/System.AddIn.Contract.Automation/RemoteParameterData.xml | Updates params documentation link. |
| xml/Microsoft.CSharp/Compiler.xml | Updates many compiler-option links to newer compiler-options pages. |
| xml/Microsoft.CSharp/CSharpCodeProvider.xml | Updates reflection article link. |
| snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Project.vbproj | Adds VB snippet project for TableAttribute. |
| snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Module1.vb | Adds VB snippet source with snippet regions. |
| snippets/csharp/System.Data.Linq/TableAttribute/Overview/Project.csproj | Adds C# snippet project for TableAttribute. |
| snippets/csharp/System.Data.Linq/TableAttribute/Overview/Program.cs | Adds C# snippet source with snippet regions. |
Comment on lines
81
to
83
| > [!NOTE] | ||
| > You can avoid most `NullReferenceException` exceptions in C# by using the [null-conditional operator](/dotnet/csharp/language-reference/operators/null-conditional-operator) (`?.`) or the [null-coalescing operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`??`). For more information, see [Nullable reference types](/dotnet/csharp/whats-new/csharp-8#nullable-reference-types). The following C# examples assume the nullable context is disabled (not recommended). | ||
| > You can avoid most `NullReferenceException` exceptions in C# by using the [null-conditional operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`?.`) or the [null-coalescing operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`??`). For more information, see [Nullable reference types](/dotnet/csharp/whats-new/csharp-version-history). The following C# examples assume the nullable context is disabled (not recommended). | ||
There was a problem hiding this comment.
The link for the null-conditional operator (?.) points to the null-coalescing operator article. This makes the guidance incorrect and sends readers to the wrong operator documentation. Update the href to the null-conditional operator page, and consider linking "Nullable reference types" to the nullable reference types section/page (not the general version history).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Prep for #10722.