X509Certificate Construtores

Definição

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Inicializa uma nova instância da classe X509Certificate.

Sobrecargas

X509Certificate()	Obsoleto. Inicializa uma nova instância da classe X509Certificate.
X509Certificate(Byte[])	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)	Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7.
X509Certificate(Byte[], SecureString)	Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.
X509Certificate(Byte[], String)	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)	Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha.
X509Certificate(String, String)	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)	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)	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)	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)	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

Cuidado

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

Inicializa uma nova instância da classe 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}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate ();

Public Sub New ()

Atributos

ObsoleteAttribute UnsupportedOSPlatformAttribute

Comentários

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

X509Certificate(Byte[])

Origem:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(IntPtr)

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(X509Certificate)

Origem:

X509Certificate.cs

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

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);

[<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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentNullException

O valor do parâmetro cert é null.

Comentários

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

X509Certificate(String)

Origem:

X509Certificate.cs

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

public:
 X509Certificate(System::String ^ fileName);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], SecureString)

Origem:

X509Certificate.cs

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)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], String)

Origem:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(SerializationInfo, StreamingContext)

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);

[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);

[<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

ObsoleteAttribute

Exceções

CryptographicException

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.

X509Certificate(String, SecureString)

Origem:

X509Certificate.cs

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)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(String, String)

Origem:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Origem:

X509Certificate.cs

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)]
[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")>]
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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Origem:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Origem:

X509Certificate.cs

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)]
[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")>]
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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.

X509Certificate(String, String, X509KeyStorageFlags)

Origem:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Exceções

CryptographicException

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.

ArgumentException

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.