Remove references to obsolete APIs#12773
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the .NET API reference ECMAXML docs by removing <altmember> cross-references that point to obsolete/deprecated APIs (CAS permissions, legacy serialization/formatters, reflection-only load APIs, deprecated networking/threading members, etc.), aligning with issue #12513’s effort to reduce legacy guidance and references.
Changes:
- Removed many
<altmember>entries that reference obsolete/deprecated APIs across BCL, WPF, networking, serialization, and collections docs. - Reduced “See also”/related cross-links to legacy framework-era APIs (for example, CAS permission types and formatter-based serialization surfaces).
- Simplified some self-referential or legacy-API reference blocks in collection and permission-related docs.
Reviewed changes
Copilot reviewed 63 out of 64 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| xml/System/Uri.xml | Removes <altmember> links to obsolete URI APIs (e.g., MakeRelative, EscapeUriString). |
| xml/System/String.xml | Removes <altmember> link to obsolete String.Copy. |
| xml/System.Windows.Media/Visual.xml | Removes <altmember> links to legacy BitmapEffect properties. |
| xml/System.Windows.Media/FormattedText.xml | Removes <altmember> link to an older/legacy constructor overload. |
| xml/System.Windows.Data/CollectionView.xml | Removes <altmember> link to a legacy/protected logging hook. |
| xml/System.Web/AspNetHostingPermission.xml | Removes <altmember> link to legacy CAS IPermission. |
| xml/System.Threading/ThreadAbortException.xml | Removes <altmember> links to obsolete Thread.Abort API. |
| xml/System.Text.RegularExpressions/RegexMatchTimeoutException.xml | Removes an <altmember> link (but this file is policy-restricted for edits; see PR comment). |
| xml/System.ServiceProcess/ServiceControllerPermissionAttribute.xml | Removes <altmember> link to legacy CAS SecurityAction. |
| xml/System.ServiceProcess/ServiceControllerPermission.xml | Removes <altmember> link to legacy CAS PermissionState. |
| xml/System.Security.Permissions/SecurityPermissionFlag.xml | Removes <altmember> link to SecurityPermissionAttribute. |
| xml/System.Security.Permissions/SecurityPermissionAttribute.xml | Removes <altmember> link to SecurityPermissionFlag. |
| xml/System.Security.Permissions/SecurityPermission.xml | Removes <altmember> links to legacy CAS-related types. |
| xml/System.Security.Permissions/PermissionSetAttribute.xml | Removes <altmember> link to legacy PermissionSet type. |
| xml/System.Runtime.Serialization/StreamingContext.xml | Removes <altmember> link to obsolete formatter-serialization-related member. |
| xml/System.Runtime.Serialization/SerializationObjectManager.xml | Removes <altmember> link to legacy serialization type. |
| xml/System.Runtime.Serialization/ObjectIDGenerator.xml | Removes <altmember> link to legacy formatter surface. |
| xml/System.Runtime.Serialization/ISafeSerializationData.xml | Removes <altmember> link to Exception.GetObjectData serialization surface. |
| xml/System.Runtime.Serialization/IFormatter.xml | Removes <altmember> link to legacy Formatter base type. |
| xml/System.Runtime.Serialization/FormatterServices.xml | Removes <altmember> link to legacy Formatter base type. |
| xml/System.Runtime.Serialization/Formatter.xml | Removes <altmember> links to legacy serialization helper type. |
| xml/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml | Removes <altmember> links to legacy formatter-related types. |
| xml/System.Runtime.InteropServices/Marshal.xml | Removes <altmember> links to obsolete Marshal.ReadByte overload. |
| xml/System.Runtime.ConstrainedExecution/ReliabilityContractAttribute.xml | Removes <altmember> links to CER-related legacy types. |
| xml/System.Runtime.ConstrainedExecution/Consistency.xml | Removes <altmember> link to ReliabilityContractAttribute. |
| xml/System.Runtime.ConstrainedExecution/Cer.xml | Removes <altmember> link to PrepareConstrainedRegions. |
| xml/System.Reflection/StrongNameKeyPair.xml | Removes <altmember> links to legacy CAS permission types. |
| xml/System.Reflection/CustomAttributeData.xml | Removes <altmember> links to reflection-only type loading API. |
| xml/System.Reflection/AssemblyName.xml | Removes <altmember> link to serialization GetObjectData member. |
| xml/System.Reflection.Emit/AssemblyBuilder.xml | Removes <altmember> link to ReflectionOnlyLoad API. |
| xml/System.Printing/PrintSystemJobInfo.xml | Removes <altmember> links to obsolete TimeZone type. |
| xml/System.Printing/PrintQueue.xml | Removes <altmember> links to obsolete TimeZone type. |
| xml/System.Net/WebPermission.xml | Removes <altmember> links to legacy CAS PermissionState. |
| xml/System.Net/WebClient.xml | Removes <altmember> link to obsolete GlobalProxySelection. |
| xml/System.Net/DnsPermissionAttribute.xml | Removes <altmember> link to legacy CAS SecurityAction. |
| xml/System.Net.Sockets/Socket.xml | Removes <altmember> links to obsolete SupportsIPv6/SupportsIPv4 guidance. |
| xml/System.Management/ManagementException.xml | Removes <altmember> link to serialization interface member. |
| xml/System.IO/FileStream.xml | Removes <altmember> link to obsolete Path.InvalidPathChars. |
| xml/System.Globalization/CultureInfo.xml | Removes <altmember> link to legacy CAS SecurityPermissionAttribute. |
| xml/System.Drawing.Printing/PrintingPermissionAttribute.xml | Removes <altmember> link to legacy CAS SecurityAction. |
| xml/System.DirectoryServices/DirectoryServicesPermissionAttribute.xml | Removes <altmember> link to legacy CAS PermissionState. |
| xml/System.DirectoryServices/DirectoryServicesPermission.xml | Removes <altmember> link to legacy CAS PermissionState. |
| xml/System.DirectoryServices/DirectoryServicesCOMException.xml | Removes <altmember> link to serialization interface member. |
| xml/System.Diagnostics/Process.xml | Removes <altmember> link to obsolete PeakWorkingSet property. |
| xml/System.Diagnostics/PerformanceCounterPermissionAttribute.xml | Removes <altmember> link to legacy CAS SecurityAction. |
| xml/System.Diagnostics/EventLogPermissionAttribute.xml | Removes <altmember> link to legacy CAS SecurityAction. |
| xml/System.Diagnostics/EventLogPermission.xml | Removes <altmember> link to legacy CAS PermissionState. |
| xml/System.Configuration/ConfigurationPermissionAttribute.xml | Removes <altmember> link to legacy CAS SecurityAction. |
| xml/System.ComponentModel/TypeDescriptor.xml | Removes <altmember> link to legacy COM descriptor handler surface. |
| xml/System.ComponentModel/RecommendedAsConfigurableAttribute.xml | Removes <altmember> entries that were redundant/self-referential. |
| xml/System.Collections/IHashCodeProvider.xml | Removes <altmember> links to obsolete hashing provider types. |
| xml/System.Collections/IEqualityComparer.xml | Removes <altmember> link to obsolete IHashCodeProvider. |
| xml/System.Collections/Hashtable.xml | Removes <altmember> links to obsolete hashing provider and legacy serialization member. |
| xml/System.Collections/CaseInsensitiveHashCodeProvider.xml | Removes <altmember> link to obsolete IHashCodeProvider. |
| xml/System.Collections/CaseInsensitiveComparer.xml | Removes <altmember> link to obsolete CaseInsensitiveHashCodeProvider. |
| xml/System.Collections.Specialized/NameValueCollection.xml | Removes <altmember> links to obsolete case-insensitive hashing providers. |
| xml/System.Collections.Specialized/NameObjectCollectionBase.xml | Removes <altmember> links to obsolete hashing providers and legacy serialization member. |
| xml/System.Collections.Specialized/HybridDictionary.xml | Removes <altmember> link to obsolete CaseInsensitiveHashCodeProvider. |
| xml/System.Collections.Specialized/CollectionsUtil.xml | Removes <altmember> links to obsolete case-insensitive hashing providers. |
| xml/System.Collections.Generic/LinkedList`1+Enumerator.xml | Removes <altmember> link to legacy serialization member. |
| xml/System.Collections.Generic/LinkedList`1.xml | Removes <altmember> link to legacy serialization member. |
| xml/System.Collections.Generic/IEqualityComparer`1.xml | Removes <altmember> link to obsolete IHashCodeProvider. |
| xml/System.Collections.Generic/Dictionary`2.xml | Removes <altmember> link to legacy serialization member. |
BillWagner
approved these changes
Jun 23, 2026
BillWagner
left a comment
Member
There was a problem hiding this comment.
I'm good with this, pending the warnings.
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.
Contributes to #12513.
Copilot did the work.