X509Certificate Construtores

Definição

Espaço de Nomes:: System.Security.Cryptography.X509Certificates

Assemblagens:: netstandard.dll, System.Security.Cryptography.dll

Assemblagens:: netstandard.dll, System.Security.Cryptography.X509Certificates.dll

Assemblagens:: netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll

Assemblagem:: System.Security.Cryptography.X509Certificates.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da X509Certificate classe.

Sobrecargas

Name	Description
X509Certificate()	Obsoleto. Obsoleto. Inicializa uma nova instância da X509Certificate classe.
X509Certificate(Byte[])	Obsoleto. Inicializa uma nova instância da X509Certificate classe definida a partir de uma sequência de bytes que representa um certificado X.509v3.
X509Certificate(IntPtr)	Inicializa uma nova instância da X509Certificate classe usando um handle numa estrutura não gerida `PCCERT_CONTEXT` .
X509Certificate(X509Certificate)	Inicializa uma nova instância da X509Certificate classe usando outra X509Certificate classe.
X509Certificate(String)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7.
X509Certificate(Byte[], SecureString)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um array de bytes e uma palavra-passe.
X509Certificate(Byte[], String)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um array de bytes e uma palavra-passe.
X509Certificate(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um SerializationInfo objeto e uma StreamingContext estrutura.
X509Certificate(String, SecureString)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um nome de ficheiro de certificado e uma palavra-passe.
X509Certificate(String, String)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7 e uma palavra-passe para aceder ao certificado.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando um nome de ficheiro de certificado, uma palavra-passe e um flag de armazenamento de chaves.
X509Certificate(String, String, X509KeyStorageFlags)	Obsoleto. Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7, uma palavra-passe para aceder ao certificado e um flag de armazenamento de chaves.

X509Certificate()

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

Atenção

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

Inicializa uma nova instância da X509Certificate classe.

public:
 X509Certificate();

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
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.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[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();

Public Sub New ()

Atributos: ObsoleteAttribute UnsupportedOSPlatformAttribute

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Aplica-se a

X509Certificate(Byte[])

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

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

public:
 X509Certificate(cli::array <System::Byte> ^ data);

[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}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate(byte[] data);

public X509Certificate(byte[] data);

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

[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Public Sub New (data As Byte())

Parâmetros

data: Byte[]

Um array de bytes contendo dados de um certificado X.509.

Atributos: ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O data parâmetro é null.

-ou-

O comprimento do data parâmetro é 0.

Exemplos

O exemplo seguinte carrega um ficheiro de certificado X.509 num X509Certificate objeto, exporta o certificado como um array de bytes e depois importa o array de bytes para outro X509Certificate objeto.

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

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Se criar um X509Certificate certificado especificando um armazenamento de ficheiros assinado por PKCS7 para data, o X509Certificate é criado para o certificado que assinou a loja em vez de para qualquer um dos certificados dentro da loja.

Aplica-se a

X509Certificate(IntPtr)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Inicializa uma nova instância da X509Certificate classe usando um handle numa estrutura não gerida PCCERT_CONTEXT .

public:
 X509Certificate(IntPtr handle);

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

public X509Certificate(IntPtr handle);

[System.Security.SecurityCritical]
public X509Certificate(IntPtr handle);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Uma maçaneta para uma estrutura não gerida PCCERT_CONTEXT .

Atributos: UnsupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

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

Observações

Este construtor cria um novo objeto X509Certificate usando um handle para o contexto Microsoft do certificado Cryptographic API, PCCERT_CONTEXT.

Importante

Este construtor cria uma cópia do contexto do certificado. Não presuma que a estrutura de contexto que passou ao construtor é válida; pode ter sido lançado. Pode obter uma cópia da estrutura atual PCCERT_CONTEXT da Handle propriedade, mas ela só é válida durante a vida útil do X509Certificate objeto.

Aplica-se a

X509Certificate(X509Certificate)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

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

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

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

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

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 X509Certificate classe a partir da qual inicializar esta classe.

Atributos: UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentNullException

O valor do cert parâmetro é null.

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Aplica-se a

X509Certificate(String)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

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

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

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

public X509Certificate(string fileName);

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

[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Public Sub New (fileName As String)

Parâmetros

fileName: String

O nome de um ficheiro assinado por PKCS7.

Atributos: ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O fileName parâmetro é null.

Exemplos

O exemplo seguinte carrega um certificado X.509 a partir de um ficheiro, chama o ToString método e apresenta os resultados na consola.

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

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Se criar um X509Certificate certificado especificando um armazenamento de ficheiros assinado por PKCS7 para fileName, o X509Certificate é criado para o certificado que assinou a loja em vez de para qualquer um dos certificados dentro da loja.

Aplica-se a

X509Certificate(Byte[], SecureString)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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 X509Certificate classe usando um array de bytes e uma palavra-passe.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);

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

public X509Certificate(byte[] rawData, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

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

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

Um array de bytes que contém dados de um certificado X.509.

password: SecureString

A palavra-passe necessária para aceder aos dados do certificado X.509.

Atributos: CLSCompliantAttribute ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O rawData parâmetro é null.

-ou-

O comprimento do rawData parâmetro é 0.

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas fixamente podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly num editor de texto como o Notepad.exe.

Se criar um X509Certificate certificado especificando um armazenamento de ficheiros assinado por PKCS7 para rawData, o X509Certificate é criado para o certificado que assinou a loja em vez de para qualquer um dos certificados dentro da loja.

Aplica-se a

X509Certificate(Byte[], String)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

Inicializa uma nova instância da X509Certificate classe usando um array de bytes e uma palavra-passe.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);

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

public X509Certificate(byte[] rawData, string? password);

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

public X509Certificate(byte[] rawData, string password);

[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Public Sub New (rawData As Byte(), password As String)

Parâmetros

rawData: Byte[]

Um array de bytes contendo dados de um certificado X.509.

password: String

A palavra-passe necessária para aceder aos dados do certificado X.509.

Atributos: ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O rawData parâmetro é null.

-ou-

O comprimento do rawData parâmetro é 0.

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Importante

Aplica-se a

X509Certificate(SerializationInfo, StreamingContext)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

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

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

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

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 que descreve informação de SerializationInfo serialização.

context: StreamingContext

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

Atributos: ObsoleteAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

Aplica-se a

X509Certificate(String, SecureString)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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 X509Certificate classe usando um nome de ficheiro de certificado e uma palavra-passe.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);

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

public X509Certificate(string fileName, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

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

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 ficheiro de certificado.

password: SecureString

A palavra-passe necessária para aceder aos dados do certificado X.509.

Atributos: CLSCompliantAttribute ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O fileName parâmetro é null.

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num contentor de chaves.

Importante

Aplica-se a

X509Certificate(String, String)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7 e uma palavra-passe para aceder ao certificado.

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

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

public X509Certificate(string fileName, string? password);

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

public X509Certificate(string fileName, string password);

[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Public Sub New (fileName As String, password As String)

Parâmetros

fileName: String

O nome de um ficheiro assinado por PKCS7.

password: String

A palavra-passe necessária para aceder aos dados do certificado X.509.

Atributos: ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O fileName parâmetro é null.

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num contentor de chaves.

Aplica-se a

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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 X509Certificate classe usando um array de bytes, uma palavra-passe e um flag 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.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}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
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);

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

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

Um array de bytes que contém dados de um certificado X.509.

password: SecureString

A palavra-passe necessária para aceder aos 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 ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O rawData parâmetro é null.

-ou-

O comprimento do rawData parâmetro é 0.

Observações

Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num Provedor de Serviços Criptográficos (CSP) da API Criptográfica da Microsoft.

ASN.1 DER é o único formato de certificado suportado por esta classe.

Importante

Aplica-se a

X509Certificate(Byte[], String, X509KeyStorageFlags)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

Inicializa uma nova instância da X509Certificate classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

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

public X509Certificate(byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

rawData: Byte[]

Um array de bytes contendo dados de um certificado X.509.

password: String

A palavra-passe necessária para aceder aos 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: ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O rawData parâmetro é null.

-ou-

O comprimento do rawData parâmetro é 0.

Observações

Este construtor cria um novo X509Certificate objeto usando um array de bytes, uma palavra-passe necessária para aceder aos dados do certificado e um flag de armazenamento de chaves. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num Provedor de Serviços Criptográficos (CSP) da API Criptográfica da Microsoft.

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

ASN.1 DER é o único formato de certificado suportado por esta classe.

Importante

Aplica-se a

X509Certificate(String, SecureString, X509KeyStorageFlags)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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 X509Certificate classe usando um nome de ficheiro de certificado, uma palavra-passe e um flag de armazenamento de chaves.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

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

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

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 ficheiro de certificado.

password: SecureString

A palavra-passe necessária para aceder aos 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 ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O fileName parâmetro é null.

Observações

Aplica-se a

X509Certificate(String, String, X509KeyStorageFlags)

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Origem:: X509Certificate.cs

Atenção

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

Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7, uma palavra-passe para aceder ao certificado e um flag de armazenamento de chaves.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

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

public X509Certificate(string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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}")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

fileName: String

O nome de um ficheiro assinado por PKCS7.

password: String

A palavra-passe necessária para aceder aos 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: ObsoleteAttribute UnsupportedOSPlatformAttribute

Exceções

CryptographicException

Ocorre um erro no certificado. Por exemplo:

O ficheiro de certificado não existe.
O certificado é inválido.
A palavra-passe do certificado está incorreta.

ArgumentException

O fileName parâmetro é null.

Observações

Aplica-se a

Comentários

Esta página foi útil?