Obsolescencias de API con id. de diagnóstico no predeterminados (.NET 7)

Algunas API se han marcado como obsoletas a partir de .NET 7. Este cambio importante es específico de las API que se han marcado como obsoletas con un identificador de diagnóstico personalizado. La supresión del identificador de diagnóstico de obsolescencia predeterminado, que es CS0618 en el caso del compilador de C#, no suprime las advertencias que genera el compilador cuando se usan estas API.

Descripción del cambio

En versiones anteriores de .NET, estas API se pueden usar sin ninguna advertencia de compilación. En .NET 7 y versiones posteriores, el uso de estas API genera una advertencia o un error en tiempo de compilación con un id. de diagnóstico personalizado. El uso de identificadores de diagnóstico personalizados permite suprimir las advertencias de obsolescencia de forma individual en lugar de realizar una supresión global de todas las advertencias de obsolescencia.

En la tabla siguiente se indican los identificadores de diagnóstico personalizados y sus mensajes de advertencia correspondientes para las API obsoletas.

Id. de diagnóstico	Descripción	severity
SYSLIB0036	Regex.CompileToAssembly está obsoleto y no se admite. Use RegexGeneratorAttribute en su lugar con el generador de origen de expresiones regulares.	Advertencia
SYSLIB0037	Los miembros HashAlgorithm, ProcessorArchitecture y VersionCompatibility de AssemblyName se consideran obsoletos y no se admiten.	Advertencia
SYSLIB0038	SerializationFormat.Binary está obsoleto y no debe usarse.	Advertencia
SYSLIB0039	Las versiones 1.0 y 1.1 de TLS tienen vulnerabilidades conocidas y no se recomiendan. En su lugar, use una versión de TLS más reciente, o bien SslProtocols.None para aplazar los valores predeterminados del sistema operativo.	Advertencia
SYSLIB0040	EncryptionPolicy.NoEncryption y EncryptionPolicy.AllowNoEncryption reducen significativamente la seguridad y no deben usarse en el código de producción.	Advertencia
SYSLIB0041	El algoritmo hash predeterminado y los recuentos de iteración en los constructores Rfc2898DeriveBytes están obsoletos y son inseguros. Use un constructor que acepte el algoritmo hash y el número de iteraciones.	Advertencia
SYSLIB0042	ToXmlString y FromXmlString no tienen ninguna implementación para los tipos de criptografía de curva elíptica (ECC) y están obsoletos. Use un formato de importación y exportación estándar, como ExportSubjectPublicKeyInfo o ImportSubjectPublicKeyInfo para claves públicas, o bien ExportPkcs8PrivateKey o ImportPkcs8PrivateKey para claves privadas.	Advertencia
SYSLIB0043	ECDiffieHellmanPublicKey.ToByteArray() y el constructor asociado no tienen ninguna implementación coherente e interoperable en todas las plataformas. Utilice ECDiffieHellmanPublicKey.ExportSubjectPublicKeyInfo() en su lugar.	Advertencia
SYSLIB0044	AssemblyName.CodeBase y AssemblyName.EscapedCodeBase están obsoletos.	Advertencia
SYSLIB0045	Los Factory Methods criptográficos que aceptan un nombre de algoritmo están obsoletos. En su lugar, use el Factory Method Create sin parámetros en el tipo de algoritmo.	Advertencia
SYSLIB0047	XmlSecureResolver está obsoleto. Use XmlResolver.ThrowingResolver en su lugar para prohibir la resolución de recursos XML externos.	Advertencia

Versión introducida

.NET 7

Tipo de cambio importante

Estas obsolescencias pueden afectar a la compatibilidad con orígenes de datos.

Acción recomendada

• Siga las instrucciones específicas proporcionadas para cada identificador de diagnóstico mediante el vínculo de dirección URL que aparece en la advertencia.

• Las advertencias o los errores de estas obsolescencias no pueden suprimirse mediante el identificador de diagnóstico estándar para tipos o miembros obsoletos; use el valor del identificador de diagnóstico SYSLIBxxxx personalizado en su lugar.

API afectadas

SYSLIB0036

• Regex.CompileToAssembly

SYSLIB0037

• AssemblyName.HashAlgorithm
• AssemblyName.ProcessorArchitecture
• AssemblyName.VersionCompatibility

SYSLIB0038

• System.Data.SerializationFormat.Binary

SYSLIB0039

• System.Security.Authentication.SslProtocols.Tls
• System.Security.Authentication.SslProtocols.Tls11

SYSLIB0040

• System.Net.Security.EncryptionPolicy.AllowNoEncryption
• System.Net.Security.EncryptionPolicy.NoEncryption

SYSLIB0041

• Rfc2898DeriveBytes(String, Byte[])
• Rfc2898DeriveBytes(String, Int32)
• Rfc2898DeriveBytes(Byte[], Byte[], Int32)
• Rfc2898DeriveBytes(String, Byte[], Int32)
• Rfc2898DeriveBytes(String, Int32, Int32)

SYSLIB0042

• System.Security.Cryptography.ECDiffieHellmanCng.FromXmlString(String, ECKeyXmlFormat)
• System.Security.Cryptography.ECDiffieHellmanCng.ToXmlString(ECKeyXmlFormat)
• System.Security.Cryptography.ECDiffieHellmanCngPublicKey.FromXmlString(String)
• System.Security.Cryptography.ECDiffieHellmanCngPublicKey.ToXmlString()
• System.Security.Cryptography.ECDiffieHellmanPublicKey.ToXmlString()
• System.Security.Cryptography.ECDsaCng.FromXmlString(String, ECKeyXmlFormat)
• System.Security.Cryptography.ECDsaCng.ToXmlString(ECKeyXmlFormat)

SYSLIB0043

• System.Security.Cryptography.ECDiffieHellmanPublicKey.ToByteArray()
• ECDiffieHellmanPublicKey(Byte[])

SYSLIB0045

• System.Security.Cryptography.Aes.Create(String)
• System.Security.Cryptography.AsymmetricAlgorithm.Create(String)
• System.Security.Cryptography.DES.Create(String)
• System.Security.Cryptography.ECDiffieHellman.Create(String)
• System.Security.Cryptography.ECDsa.Create(String)
• System.Security.Cryptography.HashAlgorithm.Create(String)
• System.Security.Cryptography.KeyedHashAlgorithm.Create(String)
• System.Security.Cryptography.RandomNumberGenerator.Create(String)
• System.Security.Cryptography.RC2.Create(String)
• System.Security.Cryptography.Rijndael.Create(String)
• System.Security.Cryptography.RSA.Create(String)
• System.Security.Cryptography.SHA1.Create(String)
• System.Security.Cryptography.SHA256.Create(String)
• System.Security.Cryptography.SHA384.Create(String)
• System.Security.Cryptography.SHA512.Create(String)
• System.Security.Cryptography.SymmetricAlgorithm.Create(String)
• System.Security.Cryptography.TripleDES.Create(String)

SYSLIB0047

• System.Xml.XmlSecureResolver

Vea también

• Obsolescencias de API con identificadores de diagnóstico no predeterminados (.NET 6)
• Obsolescencias de API con identificadores de diagnóstico no predeterminados (.NET 5)
• Características obsoletas en .NET 5+