X509Certificate2 Construtores

Definição

Inicializa uma nova instância da X509Certificate2 classe.

Sobrecargas

Name Description
X509Certificate2()
Obsoleto.
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe.

X509Certificate2(String, SecureString, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando um nome de ficheiro de certificado, uma palavra-passe e um flag de armazenamento de chaves.

X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando um nome de ficheiro de certificado, uma palavra-passe e um flag de armazenamento de chaves.

X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe a partir de dados de certificado, uma palavra-passe e flags de armazenamento de chaves.

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

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

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

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

X509Certificate2(String, String)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando um nome de ficheiro de certificado e uma palavra-passe usada para aceder ao certificado.

X509Certificate2(String, SecureString)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando um nome de ficheiro de certificado e uma palavra-passe.

X509Certificate2(String, String, X509KeyStorageFlags)
Obsoleto.

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

X509Certificate2(Byte[], String)
Obsoleto.

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

X509Certificate2(Byte[], SecureString)
Obsoleto.

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

X509Certificate2(String)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando um nome de ficheiro de certificado.

X509Certificate2(X509Certificate)

Inicializa uma nova instância da X509Certificate2 classe usando um X509Certificate objeto.

X509Certificate2(ReadOnlySpan<Byte>)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe a partir dos dados do certificado.

X509Certificate2(IntPtr)

Inicializa uma nova instância da X509Certificate2 classe usando um handle não gerido.

X509Certificate2(Byte[])
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando informação de um array de bytes.

X509Certificate2(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da X509Certificate2 classe usando a serialização especificada e a informação de contexto do fluxo.

X509Certificate2()

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe.

public:
 X509Certificate2();
[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 X509Certificate2();
public X509Certificate2();
[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 X509Certificate2();
[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 X509Certificate2();
Public Sub New ()
Atributos

Exemplos

O seguinte exemplo de código abre o armazenamento atual de certificados do utilizador, seleciona apenas certificados ativos e depois permite ao utilizador selecionar um ou mais certificados. O exemplo escreve então a informação do certificado na consola.

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class CertSelect
{
    static void Main()
    {
        X509Store store = new X509Store("MY",StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);

        X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
        X509Certificate2Collection fcollection = (X509Certificate2Collection)collection.Find(X509FindType.FindByTimeValid,DateTime.Now,false);
        X509Certificate2Collection scollection = X509Certificate2UI.SelectFromCollection(fcollection, "Test Certificate Select","Select a certificate from the following list to get information on that certificate",X509SelectionFlag.MultiSelection);
        Console.WriteLine("Number of certificates: {0}{1}",scollection.Count,Environment.NewLine);

        foreach (X509Certificate2 x509 in scollection)
        {
            try
            {
                byte[] rawdata = x509.RawData;
                Console.WriteLine("Content Type: {0}{1}",X509Certificate2.GetCertContentType(rawdata),Environment.NewLine);
                Console.WriteLine("Friendly Name: {0}{1}",x509.FriendlyName,Environment.NewLine);
                Console.WriteLine("Certificate Verified?: {0}{1}",x509.Verify(),Environment.NewLine);
                Console.WriteLine("Simple Name: {0}{1}",x509.GetNameInfo(X509NameType.SimpleName,true),Environment.NewLine);
                Console.WriteLine("Signature Algorithm: {0}{1}",x509.SignatureAlgorithm.FriendlyName,Environment.NewLine);
                Console.WriteLine("Public Key: {0}{1}",x509.PublicKey.Key.ToXmlString(false),Environment.NewLine);
                Console.WriteLine("Certificate Archived?: {0}{1}",x509.Archived,Environment.NewLine);
                Console.WriteLine("Length of Raw Data: {0}{1}",x509.RawData.Length,Environment.NewLine);
                X509Certificate2UI.DisplayCertificate(x509);
                x509.Reset();
            }
            catch (CryptographicException)
            {
                Console.WriteLine("Information could not be written out for this certificate.");
            }
        }
        store.Close();
    }
}
Imports System.Security.Cryptography
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates

Class CertSelect

    Shared Sub Main()

        Dim store As New X509Store("MY", StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)

        Dim collection As X509Certificate2Collection = CType(store.Certificates, X509Certificate2Collection)
        Dim fcollection As X509Certificate2Collection = CType(collection.Find(X509FindType.FindByTimeValid, DateTime.Now, False), X509Certificate2Collection)
        Dim scollection As X509Certificate2Collection = X509Certificate2UI.SelectFromCollection(fcollection, "Test Certificate Select", "Select a certificate from the following list to get information on that certificate", X509SelectionFlag.MultiSelection)
        Console.WriteLine("Number of certificates: {0}{1}", scollection.Count, Environment.NewLine)
         
        For Each x509 As X509Certificate2 In scollection
            Try
                Dim rawdata As Byte() = x509.RawData
                Console.WriteLine("Content Type: {0}{1}", X509Certificate2.GetCertContentType(rawdata), Environment.NewLine)
                Console.WriteLine("Friendly Name: {0}{1}", x509.FriendlyName, Environment.NewLine)
                Console.WriteLine("Certificate Verified?: {0}{1}", x509.Verify(), Environment.NewLine)
                Console.WriteLine("Simple Name: {0}{1}", x509.GetNameInfo(X509NameType.SimpleName, True), Environment.NewLine)
                Console.WriteLine("Signature Algorithm: {0}{1}", x509.SignatureAlgorithm.FriendlyName, Environment.NewLine)
                Console.WriteLine("Public Key: {0}{1}", x509.PublicKey.Key.ToXmlString(False), Environment.NewLine)
                Console.WriteLine("Certificate Archived?: {0}{1}", x509.Archived, Environment.NewLine)
                Console.WriteLine("Length of Raw Data: {0}{1}", x509.RawData.Length, Environment.NewLine)
                X509Certificate2UI.DisplayCertificate(x509)
                x509.Reset()         
             Catch cExcept As CryptographicException
                 Console.WriteLine("Information could not be written out for this certificate.")
             End Try
        Next x509

        store.Close()
    End Sub
End Class

Observações

Este construtor cria um objeto vazio X509Certificate2 , ao contrário dos outros construtores desta classe que usam informação de certificado de um array de bytes, um ponteiro ou um ficheiro de certificação.

Aplica-se a

X509Certificate2(String, SecureString, X509KeyStorageFlags)

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

public:
 X509Certificate2(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 X509Certificate2(string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate2(string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate2(string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate2(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.X509Certificate2 : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
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

Exceções

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.

Observações

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

X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)

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

[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 X509Certificate2(string fileName, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);
public X509Certificate2(string fileName, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(string fileName, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);
[<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.X509Certificate2 : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet)

Parâmetros

fileName
String

O nome de um ficheiro de certificado.

password
ReadOnlySpan<Char>

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

Exceções

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.

Observações

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 Notepad.exe.

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

Aplica-se a

X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe a partir de dados de certificado, uma palavra-passe e flags de armazenamento de chaves.

[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 X509Certificate2(ReadOnlySpan<byte> rawData, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);
public X509Certificate2(ReadOnlySpan<byte> rawData, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(ReadOnlySpan<byte> rawData, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);
[<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.X509Certificate2 : ReadOnlySpan<byte> * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : ReadOnlySpan<byte> * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : ReadOnlySpan<byte> * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (rawData As ReadOnlySpan(Of Byte), password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet)

Parâmetros

rawData
ReadOnlySpan<Byte>

Os dados do certificado a processar.

password
ReadOnlySpan<Char>

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

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 no certificado.

Aplica-se a

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.

public:
 X509Certificate2(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 X509Certificate2(byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate2(byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate2(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.X509Certificate2 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
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

Exceções

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.

Observações

Este construtor cria um novo X509Certificate2 objeto usando um array de bytes, uma palavra-passe necessária para aceder aos dados do certificado e um flag de armazenamento de chaves. É utilizado com ficheiros PKCS12 (PFX) que contêm a chave privada do certificado. 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.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 Notepad.exe.

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

Aplica-se a

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.

public:
 X509Certificate2(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 X509Certificate2(byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate2(byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate2(byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate2(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.X509Certificate2 : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
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

Exceções

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.

Observações

Este construtor é usado com ficheiros PKCS12 (PFX) que contêm a chave privada do certificado. 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.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 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

X509Certificate2(String, String)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando um nome de ficheiro de certificado e uma palavra-passe usada para aceder ao certificado.

public:
 X509Certificate2(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 X509Certificate2(string fileName, string? password);
public X509Certificate2(string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(string fileName, string? password);
public X509Certificate2(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.X509Certificate2 : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As String)

Parâmetros

fileName
String

O nome de um ficheiro de certificado.

password
String

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

Atributos

Exceções

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.

Observações

Este construtor cria um novo X509Certificate2 objeto usando um nome de ficheiro de certificado e uma palavra-passe necessária para aceder ao certificado. É utilizado com ficheiros PKCS12 (PFX) que contêm a chave privada do certificado. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num contentor de chaves.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 Notepad.exe.

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

Aplica-se a

X509Certificate2(String, SecureString)

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

public:
 X509Certificate2(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 X509Certificate2(string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate2(string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate2(string fileName, System.Security.SecureString password);
public X509Certificate2(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.X509Certificate2 : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
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

Exceções

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.

Observações

Este construtor é usado com ficheiros PKCS12 (PFX) que contêm a chave privada do certificado. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num contentor de chaves.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 Notepad.exe.

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

X509Certificate2(String, String, X509KeyStorageFlags)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando o nome de um ficheiro de certificado, uma palavra-passe usada para aceder ao certificado e uma flag de armazenamento de chaves.

public:
 X509Certificate2(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 X509Certificate2(string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate2(string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate2(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.X509Certificate2 : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parâmetros

fileName
String

O nome de um ficheiro de certificado.

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

Exceções

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.

Observações

Este construtor cria um novo X509Certificate2 objeto usando o nome de um ficheiro de certificado, uma palavra-passe necessária para aceder ao certificado e um flag de armazenamento de chaves.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 Notepad.exe.

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

Aplica-se a

X509Certificate2(Byte[], String)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando um array de bytes e uma palavra-passe.

public:
 X509Certificate2(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 X509Certificate2(byte[] rawData, string? password);
public X509Certificate2(byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(byte[] rawData, string? password);
public X509Certificate2(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.X509Certificate2 : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
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

Exceções

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.

Observações

Este construtor cria um novo X509Certificate2 objeto usando um array de bytes e uma palavra-passe necessária para aceder aos dados do certificado. É utilizado com ficheiros PKCS12 (PFX) que contêm a chave privada do certificado. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num contentor de chaves.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 Notepad.exe.

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

Aplica-se a

X509Certificate2(Byte[], SecureString)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando um array de bytes e uma palavra-passe.

public:
 X509Certificate2(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 X509Certificate2(byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate2(byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate2(byte[] rawData, System.Security.SecureString password);
public X509Certificate2(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.X509Certificate2 : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
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

Exceções

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.

Observações

Este construtor é usado com ficheiros PKCS12 (PFX) que contêm a chave privada do certificado. Chamar este construtor com a palavra-passe correta desencripta a chave privada e guarda-a num contentor de chaves.

Importante

Nunca codifiquem uma palavra-passe no seu código-fonte. As palavras-passe codificadas diretamente 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 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

X509Certificate2(String)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando um nome de ficheiro de certificado.

public:
 X509Certificate2(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 X509Certificate2(string fileName);
public X509Certificate2(string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(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.X509Certificate2 : string -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String)

Parâmetros

fileName
String

O nome de um ficheiro de certificado.

Atributos

Exceções

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.

Observações

Este construtor cria um novo X509Certificate2 objeto usando o nome de um ficheiro de certificação. Suporta codificação binária (DER) ou codificação PEM.

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

Aplica-se a

X509Certificate2(X509Certificate)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs

Inicializa uma nova instância da X509Certificate2 classe usando um X509Certificate objeto.

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

Parâmetros

certificate
X509Certificate

Um X509Certificate objeto.

Atributos

Exceções

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.

Observações

Este método cria uma nova instância da X509Certificate2 classe usando um X509Certificate objeto.

Aplica-se a

X509Certificate2(ReadOnlySpan<Byte>)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe a partir dos dados do certificado.

public:
 X509Certificate2(ReadOnlySpan<System::Byte> rawData);
[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 X509Certificate2(ReadOnlySpan<byte> rawData);
public X509Certificate2(ReadOnlySpan<byte> rawData);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(ReadOnlySpan<byte> rawData);
[<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.X509Certificate2 : ReadOnlySpan<byte> -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : ReadOnlySpan<byte> -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : ReadOnlySpan<byte> -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (rawData As ReadOnlySpan(Of Byte))

Parâmetros

rawData
ReadOnlySpan<Byte>

Os dados do certificado a processar.

Atributos

Exceções

Ocorre um erro no certificado.

Aplica-se a

X509Certificate2(IntPtr)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs

Inicializa uma nova instância da X509Certificate2 classe usando um handle não gerido.

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

Parâmetros

handle
IntPtr

nativeint

Um apontador para um contexto de certificado em código não gerido. A estrutura C é chamada PCCERT_CONTEXTde .

Atributos

Exceções

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.

Observações

Este construtor cria um novo objeto X509Certificate2 usando um handle para o contexto Microsoft do certificado Cryptographic API, PCCERT_CONTEXT. Note que o chamador imediato deste construtor requer permissão de código não gerido.

Importante

O 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 X509Certificate2 objeto.

Aplica-se a

X509Certificate2(Byte[])

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando informação de um array de bytes.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData);
[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 X509Certificate2(byte[] rawData);
public X509Certificate2(byte[] rawData);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2(byte[] rawData);
[<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.X509Certificate2 : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (rawData As Byte())

Parâmetros

rawData
Byte[]

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

Atributos

Exceções

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.

Observações

Este construtor cria um novo X509Certificate2 objeto usando informação de certificado de um array de bytes. O array de bytes pode ser codificado em binário (DER) ou dados X.509 codificados em PEM. O array de bytes pode também ser um ficheiro assinado PKCS7 (Authenticode); O certificado do signatário é usado para criar o objeto.

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

Aplica-se a

X509Certificate2(SerializationInfo, StreamingContext)

Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.cs
Origem:
X509Certificate2.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 X509Certificate2 classe usando a serialização especificada e a informação de contexto do fluxo.

protected:
 X509Certificate2(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}")]
protected X509Certificate2(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
protected X509Certificate2(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.X509Certificate2 : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate2
new System.Security.Cryptography.X509Certificates.X509Certificate2 : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate2
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info
SerializationInfo

A informação de serialização necessária para desserializar o novo X509Certificate2.

context
StreamingContext

Informação contextual sobre a origem do fluxo a desserializar.

Atributos

Exceções

.NET Core e .NET 5+ apenas: Em todos os casos.

Aplica-se a