X509Certificate Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe X509Certificate.
Sobrecargas
X509Certificate() |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate. |
X509Certificate(Byte[]) |
Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3. |
X509Certificate(IntPtr) |
Inicializa uma nova instância da classe X509Certificate usando um identificador para uma estrutura |
X509Certificate(X509Certificate) |
Inicializa uma nova instância da classe X509Certificate usando outra classe X509Certificate. |
X509Certificate(String) |
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7. |
X509Certificate(Byte[], SecureString) |
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha. |
X509Certificate(Byte[], String) |
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha. |
X509Certificate(SerializationInfo, StreamingContext) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext. |
X509Certificate(String, SecureString) |
Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha. |
X509Certificate(String, String) |
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado por PKCS7 e uma senha para acessar o certificado. |
X509Certificate(Byte[], SecureString, X509KeyStorageFlags) |
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves. |
X509Certificate(Byte[], String, X509KeyStorageFlags) |
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves. |
X509Certificate(String, SecureString, X509KeyStorageFlags) |
Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves. |
X509Certificate(String, String, X509KeyStorageFlags) |
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo com sinal PKCS7, uma senha para acessar o certificado e um sinalizador de armazenamento de chaves. |
X509Certificate()
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Cuidado
X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.
Inicializa uma nova instância da classe X509Certificate.
public:
X509Certificate();
public X509Certificate ();
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate ();
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate ();
Public Sub New ()
- Atributos
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Aplica-se a
X509Certificate(Byte[])
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3.
public:
X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate (byte[] data);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);
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[]
Uma matriz de bytes que contém dados de um certificado X.509.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
Exemplos
O exemplo a seguir carrega um arquivo de certificado X.509 em um X509Certificate objeto , exporta o certificado como uma matriz de bytes e importa a matriz de bytes para outro X509Certificate objeto.
using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
// The path to the certificate.
String^ Certificate = L"test.pfx";
// Load the certificate into an X509Certificate object.
X509Certificate^ cert = gcnew X509Certificate( Certificate );
array<Byte>^certData = cert->Export( X509ContentType::Cert );
X509Certificate^ newCert = gcnew X509Certificate( certData );
// Get the value.
String^ resultsTrue = newCert->ToString( true );
// Display the value to the console.
Console::WriteLine( resultsTrue );
// Get the value.
String^ resultsFalse = newCert->ToString( false );
// Display the value to the console.
Console::WriteLine( resultsFalse );
}
using System;
using System.Security.Cryptography.X509Certificates;
public class X509
{
public static void Main()
{
// The path to the certificate.
string Certificate = "test.pfx";
// Load the certificate into an X509Certificate object.
X509Certificate cert = new X509Certificate(Certificate);
byte[] certData = cert.Export(X509ContentType.Cert);
X509Certificate newCert = new X509Certificate(certData);
// Get the value.
string resultsTrue = newCert.ToString(true);
// Display the value to the console.
Console.WriteLine(resultsTrue);
// Get the value.
string resultsFalse = newCert.ToString(false);
// Display the value to the console.
Console.WriteLine(resultsFalse);
}
}
Imports System.Security.Cryptography.X509Certificates
Module X509
Sub Main()
' The path to the certificate.
Dim Certificate As String = "test.pfx"
' Load the certificate into an X509Certificate object.
Dim cert As New X509Certificate(Certificate)
Dim certData As Byte() = cert.Export(X509ContentType.Cert)
Dim newCert As New X509Certificate(certData)
' Get the value.
Dim resultsTrue As String = newCert.ToString(True)
' Display the value to the console.
Console.WriteLine(resultsTrue)
' Get the value.
Dim resultsFalse As String = newCert.ToString(False)
' Display the value to the console.
Console.WriteLine(resultsFalse)
End Sub
End Module
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para data
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(IntPtr)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando um identificador para uma estrutura PCCERT_CONTEXT
não gerenciada.
public:
X509Certificate(IntPtr handle);
public X509Certificate (IntPtr handle);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);
[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Security.SecurityCritical>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (handle As IntPtr)
Parâmetros
- handle
-
IntPtr
nativeint
Um identificador para uma estrutura PCCERT_CONTEXT
não gerenciada.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O parâmetro do identificador não representa uma estrutura PCCERT_CONTEXT
válida.
Comentários
Esse construtor cria um novo X509Certificate objeto usando um identificador para o contexto de certificado da API Criptográfica da Microsoft, PCCERT_CONTEXT
.
Importante
Esse construtor cria uma cópia do contexto do certificado. Não suponha que a estrutura de contexto passada para o construtor seja válida; ele pode ter sido liberado. Você pode obter uma cópia da estrutura atual PCCERT_CONTEXT
da Handle propriedade , mas ela é válida somente durante o tempo de vida do X509Certificate objeto.
Aplica-se a
X509Certificate(X509Certificate)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando outra classe X509Certificate.
public:
X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (cert As X509Certificate)
Parâmetros
- cert
- X509Certificate
Uma classe X509Certificate da qual essa classe será inicializada.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O valor do parâmetro cert
é null
.
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Aplica-se a
X509Certificate(String)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7.
public:
X509Certificate(System::String ^ fileName);
public X509Certificate (string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);
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 arquivo assinado PKCS7.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O parâmetro fileName
é null
.
Exemplos
O exemplo a seguir carrega um certificado X.509 de um arquivo, chama o ToString método e exibe os resultados para o console.
using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
// The path to the certificate.
String^ Certificate = L"Certificate.cer";
// Load the certificate into an X509Certificate object.
X509Certificate^ cert = gcnew X509Certificate( Certificate );
// Get the value.
String^ resultsTrue = cert->ToString( true );
// Display the value to the console.
Console::WriteLine( resultsTrue );
// Get the value.
String^ resultsFalse = cert->ToString( false );
// Display the value to the console.
Console::WriteLine( resultsFalse );
}
using System;
using System.Security.Cryptography.X509Certificates;
public class X509
{
public static void Main()
{
// The path to the certificate.
string Certificate = "Certificate.cer";
// Load the certificate into an X509Certificate object.
X509Certificate cert = new X509Certificate(Certificate);
// Get the value.
string resultsTrue = cert.ToString(true);
// Display the value to the console.
Console.WriteLine(resultsTrue);
// Get the value.
string resultsFalse = cert.ToString(false);
// Display the value to the console.
Console.WriteLine(resultsFalse);
}
}
Imports System.Security.Cryptography.X509Certificates
Module X509
Sub Main()
' The path to the certificate.
Dim Certificate As String = "Certificate.cer"
' Load the certificate into an X509Certificate object.
Dim cert As New X509Certificate(Certificate)
' Get the value.
Dim resultsTrue As String = cert.ToString(True)
' Display the value to the console.
Console.WriteLine(resultsTrue)
' Get the value.
Dim resultsFalse As String = cert.ToString(False)
' Display the value to the console.
Console.WriteLine(resultsFalse)
End Sub
End Module
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(Byte[], SecureString)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Importante
Esta API não está em conformidade com CLS.
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.
public:
X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);
public X509Certificate (byte[] rawData, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString)
Parâmetros
- rawData
- Byte[]
Uma matriz de bytes que contém dados de um certificado X.509.
- password
- SecureString
A senha necessária para acessar os dados do certificado X.509.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Importante
Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(Byte[], String)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.
public:
X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate (byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);
public X509Certificate (byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String)
Parâmetros
- rawData
- Byte[]
Uma matriz de bytes que contém dados de um certificado X.509.
- password
- String
A senha necessária para acessar os dados do certificado X.509.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Importante
Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(SerializationInfo, StreamingContext)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Cuidado
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext.
public:
X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (info As SerializationInfo, context As StreamingContext)
Parâmetros
- info
- SerializationInfo
Um objeto SerializationInfo que descreve as informações de serialização.
- context
- StreamingContext
Uma estrutura StreamingContext que descreve como a serialização deve ser executada.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
Aplica-se a
X509Certificate(String, SecureString)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Importante
Esta API não está em conformidade com CLS.
Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha.
public:
X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);
public X509Certificate (string fileName, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString)
Parâmetros
- fileName
- String
O nome de um arquivo de certificado.
- password
- SecureString
A senha necessária para acessar os dados do certificado X.509.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O parâmetro fileName
é null
.
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe. Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um contêiner de chaves.
Importante
Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(String, String)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado por PKCS7 e uma senha para acessar o certificado.
public:
X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate (string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);
public X509Certificate (string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String)
Parâmetros
- fileName
- String
O nome de um arquivo assinado PKCS7.
- password
- String
A senha necessária para acessar os dados do certificado X.509.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O parâmetro fileName
é null
.
Comentários
O ASN.1 DER é o único formato de certificado compatível com essa classe. Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um contêiner de chaves.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Importante
Esta API não está em conformidade com CLS.
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
public:
X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)
Parâmetros
- rawData
- Byte[]
Uma matriz de bytes que contém dados de um certificado X.509.
- password
- SecureString
A senha necessária para acessar os dados do certificado X.509.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
Comentários
Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um CSP (Provedor de Serviços Criptográficos) da API Criptográfica da Microsoft.
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Importante
Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(Byte[], String, X509KeyStorageFlags)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
public:
X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)
Parâmetros
- rawData
- Byte[]
Uma matriz de bytes que contém dados de um certificado X.509.
- password
- String
A senha necessária para acessar os dados do certificado X.509.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
Comentários
Esse construtor cria um novo X509Certificate objeto usando uma matriz de bytes, uma senha necessária para acessar os dados do certificado e um sinalizador de armazenamento de chaves. Chamar esse construtor com a senha correta descriptografa a chave privada e a salva em um CSP (Provedor de Serviços Criptográficos) da API Criptográfica da Microsoft.
O X509KeyStorageFlags valor pode ser usado para controlar onde e como a chave privada é importada.
O ASN.1 DER é o único formato de certificado compatível com essa classe.
Importante
Nunca embuta uma senha no código-fonte. Senhas embutidas em código podem ser recuperadas de um assembly usando o Ildasm.exe (IL Disassembler), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto, como Notepad.exe.
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para rawData
, o X509Certificate será criado para o certificado que assinou o repositório em vez de para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(String, SecureString, X509KeyStorageFlags)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Importante
Esta API não está em conformidade com CLS.
Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.
public:
X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)
Parâmetros
- fileName
- String
O nome de um arquivo de certificado.
- password
- SecureString
A senha necessária para acessar os dados do certificado X.509.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O parâmetro fileName
é null
.
Comentários
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName
, o X509Certificate será criado para o certificado que assinou o repositório e não para qualquer um dos certificados dentro do repositório.
Aplica-se a
X509Certificate(String, String, X509KeyStorageFlags)
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
- Origem:
- X509Certificate.cs
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo com sinal PKCS7, uma senha para acessar o certificado e um sinalizador de armazenamento de chaves.
public:
X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)
Parâmetros
- fileName
- String
O nome de um arquivo assinado PKCS7.
- password
- String
A senha necessária para acessar os dados do certificado X.509.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar o certificado.
- Atributos
Exceções
Ocorre um erro com o certificado. Por exemplo:
O arquivo de certificado não existe.
O certificado é inválido.
A senha do certificado está incorreta.
O parâmetro fileName
é null
.
Comentários
Se você criar um X509Certificate certificado especificando um repositório de arquivos assinado PKCS7 para fileName
, o X509Certificate será criado para o certificado que assinou o repositório e não para qualquer um dos certificados dentro do repositório.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários