Alguns construtores de X509Certificate2 e X509Certificate estão obsoletos

Os construtores em X509Certificate e X509Certificate2 que aceitam conteúdo como um byte[], ReadOnlySpan<byte> ou um caminho de arquivo string estão obsoletos, a partir do .NET 9. Os métodos Import no X509Certificate2Collection também estão obsoletos. Chamá-los no código gera aviso SYSLIB0057 em tempo de compilação.

Comportamento anterior

Os desenvolvedores podem usar as APIs afetadas sem um aviso obsoleto.

Novo comportamento

As APIs afetadas receberão um aviso de compilação obsoleto com a ID SYSLIB0057.

Versão introduzida

.NET 9 versão prévia 7

Tipo de alteração interruptiva

Essa alteração pode afetar a compatibilidade da origem.

Motivo da alteração

As APIs afetadas dão suporte ao carregamento de certificados em diversos formatos. Por exemplo, new X509Certificate2(data) carregou um certificado de um byte[] chamado data. data pode ser um dos formatos com suporte, incluindo X.509, PKCS7 ou PKCS12/PFX.

Embora esse método fosse fácil de usar, ele criava problemas em que os dados fornecidos pelo usuário eram passados em um formato diferente do pretendido. Isso pode permitir o carregamento de PKCS12, quando apenas o conteúdo X.509 deveria ser carregado. Ou pode criar problemas de interoperabilidade por lidar com os dados de maneiras diferentes.

Ação recomendada

Para obter soluções alternativas, consulte Solução alternativa.

APIs afetadas

Para APIs afetadas, consulte SYSLIB0057.