add syslib0037 (#27855)

Author: gewarren

docs/core/compatibility/core-libraries/7.0/obsolete-apis-with-custom-diagnostics.md

@@ -17,6 +17,7 @@ The following table lists the custom diagnostic IDs and their corresponding warn
 | Diagnostic ID | Description | Severity |
 | - | - |
 | [SYSLIB0036](../../../../fundamentals/syslib-diagnostics/syslib0036.md) | <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=nameWithType> is obsolete and not supported. Use `RegexGeneratorAttribute` with the regular expression source generator instead. | Warning |
+| [SYSLIB0037](../../../../fundamentals/syslib-diagnostics/syslib0037.md) | <xref:System.Reflection.AssemblyName> members <xref:System.Reflection.AssemblyName.HashAlgorithm>, <xref:System.Reflection.AssemblyName.ProcessorArchitecture>, and <xref:System.Reflection.AssemblyName.VersionCompatibility> are obsolete and not supported. | Warning |
 
 ## Version introduced
 
@@ -38,6 +39,12 @@ These obsoletions can affect [source compatibility](../../categories.md#source-c
 
 - <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=nameWithType>
 
+### SYSLIB0037
+
+- <xref:System.Reflection.AssemblyName.HashAlgorithm?displayProperty=nameWithType>
+- <xref:System.Reflection.AssemblyName.ProcessorArchitecture?displayProperty=nameWithType>
+- <xref:System.Reflection.AssemblyName.VersionCompatibility?displayProperty=nameWithType>
+
 ## See also
 
 - [API obsoletions with non-default diagnostic IDs (.NET 6)](../6.0/obsolete-apis-with-custom-diagnostics.md)

docs/fundamentals/syslib-diagnostics/obsoletions-overview.md

@@ -57,6 +57,7 @@ The following table provides an index to the `SYSLIB0XXX` obsoletions in .NET 5+
 | [SYSLIB0034][0034] | Warning | <xref:System.Security.Cryptography.Pkcs.CmsSigner.%23ctor(System.Security.Cryptography.CspParameters)> is obsolete. Use an alternative constructor instead. |
 | [SYSLIB0035][0035] | Warning | <xref:System.Security.Cryptography.Pkcs.SignerInfo.ComputeCounterSignature?displayProperty=nameWithType> is obsolete. Use the overload that accepts a <xref:System.Security.Cryptography.Pkcs.CmsSigner> instead. |
 | [SYSLIB0036][0036] | Warning | <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=nameWithType> is obsolete and not supported. Use `RegexGeneratorAttribute` with the regular expression source generator instead. |
+| [SYSLIB0037][0037] | Warning | <xref:System.Reflection.AssemblyName> members <xref:System.Reflection.AssemblyName.HashAlgorithm>, <xref:System.Reflection.AssemblyName.ProcessorArchitecture>, and <xref:System.Reflection.AssemblyName.VersionCompatibility> are obsolete and not supported. |
 
 <!-- Include adds ## Suppress warnings (H2 heading) -->
 [!INCLUDE [suppress-syslib-warning](includes/suppress-syslib-warning.md)]
@@ -97,3 +98,4 @@ The following table provides an index to the `SYSLIB0XXX` obsoletions in .NET 5+
 [0034]: syslib0034.md
 [0035]: syslib0035.md
 [0036]: syslib0036.md
+[0037]: syslib0037.md

docs/fundamentals/syslib-diagnostics/syslib0037.md

@@ -0,0 +1,20 @@
+---
+title: SYSLIB0037 warning - AssemblyName members HashAlgorithm, ProcessorArchitecture, and VersionCompatibility are obsolete
+description: Learn about the obsoletion of some AssemblyName properties that generates compile-time warning SYSLIB0037.
+ms.date: 01/13/2022
+---
+# SYSLIB0037: AssemblyName members HashAlgorithm, ProcessorArchitecture, and VersionCompatibility are obsolete
+
+The following <xref:System.Reflection.AssemblyName?displayProperty=fullName> properties are marked as obsolete, starting in .NET 7. Using these APIs in code generates warning `SYSLIB0037` at compile time.
+
+- <xref:System.Reflection.AssemblyName.HashAlgorithm>
+- <xref:System.Reflection.AssemblyName.ProcessorArchitecture>
+- <xref:System.Reflection.AssemblyName.VersionCompatibility>
+
+These properties are not a proper part of an <xref:System.Reflection.AssemblyName> instance. They don't roundtrip through <xref:System.Reflection.AssemblyName> string representation, and they are ignored by the assembly loader in .NET Core.
+
+## Workaround
+
+Don't use these members in scenarios where it was expected for the values to be round-tripped through the string representation of the <xref:System.Reflection.AssemblyName>.
+
+[!INCLUDE [suppress-syslib-warning](includes/suppress-syslib-warning.md)]

docs/fundamentals/toc.yml

@@ -462,6 +462,8 @@ items:
         href: syslib-diagnostics/syslib0035.md
       - name: SYSLIB0036
         href: syslib-diagnostics/syslib0036.md
+      - name: SYSLIB0037
+        href: syslib-diagnostics/syslib0037.md
     - name: Source-generated code
       items:
       - name: Overview