Partilhar via


X509Certificate Construtores

Definição

Inicializa uma nova instância da classe X509Certificate.

Sobrecargas

X509Certificate()
Obsoleto.
Obsoleto.

Inicializa uma nova instância da classe X509Certificate.

X509Certificate(Byte[])
Obsoleto.

Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3.

X509Certificate(IntPtr)

Inicializa uma nova instância da classe X509Certificate usando um identificador para uma estrutura PCCERT_CONTEXT não gerenciada.

X509Certificate(X509Certificate)

Inicializa uma nova instância da classe X509Certificate usando outra classe X509Certificate.

X509Certificate(String)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7.

X509Certificate(Byte[], SecureString)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.

X509Certificate(Byte[], String)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.

X509Certificate(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext.

X509Certificate(String, SecureString)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha.

X509Certificate(String, String)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado por PKCS7 e uma senha para acessar o certificado.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.

X509Certificate(Byte[], String, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.

X509Certificate(String, SecureString, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.

X509Certificate(String, String, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo com sinal PKCS7, uma senha para acessar o certificado e um sinalizador de armazenamento de chaves.

X509Certificate()

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Cuidado

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Inicializa uma nova instância da classe X509Certificate.

public:
 X509Certificate();
public X509Certificate ();
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate ();
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate ();
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate ();
Public Sub New ()
Atributos

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Aplica-se a

X509Certificate(Byte[])

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3.

public:
 X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate (byte[] data);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] data);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (data As Byte())

Parâmetros

data
Byte[]

Uma matriz de bytes que contém dados de um certificado X.509.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro rawData é null.

- ou -

O tamanho do parâmetro rawData é 0.

Exemplos

O exemplo a seguir carrega um arquivo de certificado X.509 em um X509Certificate objeto , exporta o certificado como uma matriz de bytes e importa a matriz de bytes para outro X509Certificate objeto.

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"test.pfx";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate( Certificate );
   array<Byte>^certData = cert->Export( X509ContentType::Cert );
   X509Certificate^ newCert = gcnew X509Certificate( certData );
   
   // Get the value.
   String^ resultsTrue = newCert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = newCert->ToString( false );
   
   // Display the value to the console.
   Console::WriteLine( resultsFalse );
}
using System;
using System.Security.Cryptography.X509Certificates;

public class X509
{

    public static void Main()
    {

        // The path to the certificate.
        string Certificate = "test.pfx";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        byte[] certData = cert.Export(X509ContentType.Cert);

        X509Certificate newCert = new X509Certificate(certData);

        // Get the value.
        string resultsTrue = newCert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = newCert.ToString(false);

        // Display the value to the console.
        Console.WriteLine(resultsFalse);
    }
}
Imports System.Security.Cryptography.X509Certificates


Module X509

    Sub Main()

        ' The path to the certificate.
        Dim Certificate As String = "test.pfx"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)


        Dim certData As Byte() = cert.Export(X509ContentType.Cert)

        Dim newCert As New X509Certificate(certData)

        ' Get the value.
        Dim resultsTrue As String = newCert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = newCert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para data, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(IntPtr)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Inicializa uma nova instância da classe X509Certificate usando um identificador para uma estrutura PCCERT_CONTEXT não gerenciada.

public:
 X509Certificate(IntPtr handle);
public X509Certificate (IntPtr handle);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);
[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Security.SecurityCritical>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (handle As IntPtr)

Parâmetros

handle
IntPtr

nativeint

Um identificador para uma estrutura PCCERT_CONTEXT não gerenciada.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro do identificador não representa uma estrutura PCCERT_CONTEXT válida.

Comentários

Esse construtor cria um novo X509Certificate objeto usando um identificador para o contexto de certificado da API Criptográfica da Microsoft, PCCERT_CONTEXT.

Importante

Esse construtor cria uma cópia do contexto do certificado. Não suponha que a estrutura de contexto passada para o construtor seja válida; ele pode ter sido liberado. Você pode obter uma cópia da estrutura atual PCCERT_CONTEXT da Handle propriedade , mas ela é válida somente durante o tempo de vida do X509Certificate objeto.

Aplica-se a

X509Certificate(X509Certificate)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Inicializa uma nova instância da classe X509Certificate usando outra classe X509Certificate.

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (cert As X509Certificate)

Parâmetros

cert
X509Certificate

Uma classe X509Certificate da qual essa classe será inicializada.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O valor do parâmetro cert é null.

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Aplica-se a

X509Certificate(String)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7.

public:
 X509Certificate(System::String ^ fileName);
public X509Certificate (string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String)

Parâmetros

fileName
String

O nome de um arquivo assinado PKCS7.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro fileName é null.

Exemplos

O exemplo a seguir carrega um certificado X.509 de um arquivo, chama o ToString método e exibe os resultados para o console.

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"Certificate.cer";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate( Certificate );
   
   // Get the value.
   String^ resultsTrue = cert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = cert->ToString( false );
   
   // Display the value to the console.
   Console::WriteLine( resultsFalse );
}
using System;
using System.Security.Cryptography.X509Certificates;

public class X509
{

    public static void Main()
    {

        // The path to the certificate.
        string Certificate = "Certificate.cer";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        // Get the value.
        string resultsTrue = cert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = cert.ToString(false);

        // Display the value to the console.
        Console.WriteLine(resultsFalse);
    }
}
Imports System.Security.Cryptography.X509Certificates

Module X509

    Sub Main()

        ' The path to the certificate.
        Dim Certificate As String = "Certificate.cer"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)

        ' Get the value.
        Dim resultsTrue As String = cert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = cert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(Byte[], SecureString)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);
public X509Certificate (byte[] rawData, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString)

Parâmetros

rawData
Byte[]

Uma matriz de bytes que contém dados de um certificado X.509.

password
SecureString

A senha necessária para acessar os dados do certificado X.509.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro rawData é null.

- ou -

O tamanho do parâmetro rawData é 0.

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Importante

Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(Byte[], String)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate (byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, string? password);
public X509Certificate (byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String)

Parâmetros

rawData
Byte[]

Uma matriz de bytes que contém dados de um certificado X.509.

password
String

A senha necessária para acessar os dados do certificado X.509.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro rawData é null.

- ou -

O tamanho do parâmetro rawData é 0.

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Importante

Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(SerializationInfo, StreamingContext)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext.

public:
 X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info
SerializationInfo

Um objeto SerializationInfo que descreve as informações de serialização.

context
StreamingContext

Uma estrutura StreamingContext que descreve como a serialização deve ser executada.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

Aplica-se a

X509Certificate(String, SecureString)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);
public X509Certificate (string fileName, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString)

Parâmetros

fileName
String

O nome de um arquivo de certificado.

password
SecureString

A senha necessária para acessar os dados do certificado X.509.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro fileName é null.

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe. Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um contêiner de chaves.

Importante

Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(String, String)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado por PKCS7 e uma senha para acessar o certificado.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate (string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, string? password);
public X509Certificate (string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String)

Parâmetros

fileName
String

O nome de um arquivo assinado PKCS7.

password
String

A senha necessária para acessar os dados do certificado X.509.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro fileName é null.

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe. Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um contêiner de chaves.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

rawData
Byte[]

Uma matriz de bytes que contém dados de um certificado X.509.

password
SecureString

A senha necessária para acessar os dados do certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro rawData é null.

- ou -

O tamanho do parâmetro rawData é 0.

Comentários

Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um CSP (Provedor de Serviços Criptográficos) da API Criptográfica da Microsoft.

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Importante

Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(Byte[], String, X509KeyStorageFlags)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

rawData
Byte[]

Uma matriz de bytes que contém dados de um certificado X.509.

password
String

A senha necessária para acessar os dados do certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro rawData é null.

- ou -

O tamanho do parâmetro rawData é 0.

Comentários

Esse construtor cria um novo X509Certificate objeto usando uma matriz de bytes, uma senha necessária para acessar os dados do certificado e um sinalizador de armazenamento de chaves. Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um CSP (Provedor de Serviços Criptográficos) da API Criptográfica da Microsoft.

O X509KeyStorageFlags valor pode ser usado para controlar onde e como a chave privada é importada.

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Importante

Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(String, SecureString, X509KeyStorageFlags)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Importante

Esta API não está em conformidade com CLS.

Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

fileName
String

O nome de um arquivo de certificado.

password
SecureString

A senha necessária para acessar os dados do certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro fileName é null.

Comentários

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName, o X509Certificate será criado para o certificado que assinou o repositório e não para qualquer um dos certificados dentro do repositório.

Aplica-se a

X509Certificate(String, String, X509KeyStorageFlags)

Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Cuidado

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo com sinal PKCS7, uma senha para acessar o certificado e um sinalizador de armazenamento de chaves.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

fileName
String

O nome de um arquivo assinado PKCS7.

password
String

A senha necessária para acessar os dados do certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.

Atributos

Exceções

Ocorre um erro com o certificado. Por exemplo:

  • O arquivo de certificado não existe.

  • O certificado é inválido.

  • A senha do certificado está incorreta.

O parâmetro fileName é null.

Comentários

Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName, o X509Certificate será criado para o certificado que assinou o repositório e não para qualquer um dos certificados dentro do repositório.

Aplica-se a