Skip to content

Remove references to obsolete APIs#12773

Merged
gewarren merged 4 commits into
dotnet:mainfrom
gewarren:cleanup-062226
Jun 23, 2026
Merged

Remove references to obsolete APIs#12773
gewarren merged 4 commits into
dotnet:mainfrom
gewarren:cleanup-062226

Conversation

@gewarren

Copy link
Copy Markdown
Collaborator

Contributes to #12513.

Copilot did the work.

Copilot AI review requested due to automatic review settings June 22, 2026 20:31
@github-actions github-actions Bot added the area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable. label Jun 22, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread xml/System.Text.RegularExpressions/RegexMatchTimeoutException.xml

@BillWagner BillWagner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm good with this, pending the warnings.

@gewarren gewarren merged commit 4e93b37 into dotnet:main Jun 23, 2026
5 of 6 checks passed
@gewarren gewarren deleted the cleanup-062226 branch June 23, 2026 16:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Meta Concerns something that extends across runtime area boundaries, for example, IDisposable.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants