X509Certificate Costruttori

Definizione

Inizializza una nuova istanza della classe X509Certificate.Initializes a new instance of the X509Certificate class.

Overload

X509Certificate()

Inizializza una nuova istanza della classe X509Certificate.Initializes a new instance of the X509Certificate class.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Inizializza una nuova istanza della classe X509Certificate usando un nome di file di certificato, una password e un flag di archiviazione delle chiavi.Initializes a new instance of the X509Certificate class using a certificate file name, a password, and a key storage flag.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte, una password e un flag di archiviazione delle chiavi.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte, una password e un flag di archiviazione delle chiavi.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(String, String)

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7 e una password per accedere al certificato.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file and a password to access the certificate.

X509Certificate(String, SecureString)

Inizializza una nuova istanza della classe X509Certificate usando un nome di file di certificato e una password.Initializes a new instance of the X509Certificate class using a certificate file name and a password.

X509Certificate(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe X509Certificate usando un oggetto SerializationInfo e una struttura StreamingContext.Initializes a new instance of the X509Certificate class using a SerializationInfo object and a StreamingContext structure.

X509Certificate(String, String, X509KeyStorageFlags)

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7, una password per accedere al certificato e un flag di archiviazione chiavi.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file, a password to access the certificate, and a key storage flag.

X509Certificate(Byte[], SecureString)

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte e una password.Initializes a new instance of the X509Certificate class using a byte array and a password.

X509Certificate(String)

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

X509Certificate(X509Certificate)

Inizializza una nuova istanza della classe X509Certificate usando un'altra classe X509Certificate.Initializes a new instance of the X509Certificate class using another X509Certificate class.

X509Certificate(IntPtr)

Inizializza una nuova istanza della classe X509Certificate tramite un handle per una struttura PCCERT_CONTEXT non gestita.Initializes a new instance of the X509Certificate class using a handle to an unmanaged PCCERT_CONTEXT structure.

X509Certificate(Byte[])

Inizializza una nuova istanza della classe X509Certificate definita da una sequenza di byte che rappresenta un certificato X.509v3.Initializes a new instance of the X509Certificate class defined from a sequence of bytes representing an X.509v3 certificate.

X509Certificate(Byte[], String)

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte e una password.Initializes a new instance of the X509Certificate class using a byte array and a password.

X509Certificate()

Inizializza una nuova istanza della classe X509Certificate.Initializes a new instance of the X509Certificate class.

public:
 X509Certificate();
public X509Certificate ();
Public Sub New ()

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe X509Certificate usando un nome di file di certificato, una password e un flag di archiviazione delle chiavi.Initializes a new instance of the X509Certificate class using a certificate file name, a password, and a key storage flag.

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

Parametri

fileName
String

Nome di un file di certificato.The name of a certificate file.

password
SecureString

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.A bitwise combination of the enumeration values that control where and how to import the certificate.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro fileName è null.The fileName parameter is null.

Commenti

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per fileName, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

FileIOPermission
autorizzazione per la lettura del file descritto dal parametro fileName.for permission to read the file described by the fileName parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: ReadAssociated enumeration: Read

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(Byte[], String, X509KeyStorageFlags)

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte, una password e un flag di archiviazione delle chiavi.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

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

Parametri

rawData
Byte[]

Matrice di byte contenente i dati di un certificato X.509.A byte array containing data from an X.509 certificate.

password
String

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.A bitwise combination of the enumeration values that control where and how to import the certificate.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro rawData è null.The rawData parameter is null.

-oppure--or- La lunghezza del parametro rawData è 0.The length of the rawData parameter is 0.

Commenti

Questo costruttore crea un nuovo oggetto X509Certificate usando una matrice di byte, una password necessaria per accedere ai dati del certificato e un flag di archiviazione delle chiavi.This constructor creates a new X509Certificate object using a byte array, a password that is needed to access the certificate data, and a key storage flag. La chiamata di questo costruttore con la password corretta decrittografa la chiave privata e la Salva in un provider del servizio di crittografia (CSP) dell'API di crittografia Microsoft.Calling this constructor with the correct password decrypts the private key and saves it to a Microsoft Cryptographic API Cryptographic Service Provider (CSP).

Il valore X509KeyStorageFlags può essere utilizzato per controllare la posizione e la modalità di importazione della chiave privata.The X509KeyStorageFlags value can be used to control where and how the private key is imported.

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per rawData, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte, una password e un flag di archiviazione delle chiavi.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

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

Parametri

rawData
Byte[]

Matrice di byte contenente i dati di un certificato X.509.A byte array that contains data from an X.509 certificate.

password
SecureString

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.A bitwise combination of the enumeration values that control where and how to import the certificate.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro rawData è null.The rawData parameter is null.

-oppure--or- La lunghezza del parametro rawData è 0.The length of the rawData parameter is 0.

Commenti

La chiamata di questo costruttore con la password corretta decrittografa la chiave privata e la Salva in un provider del servizio di crittografia (CSP) dell'API di crittografia Microsoft.Calling this constructor with the correct password decrypts the private key and saves it to a Microsoft Cryptographic API Cryptographic Service Provider (CSP).

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per rawData, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(String, String)

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7 e una password per accedere al certificato.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file and a password to access the certificate.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate (string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String)

Parametri

fileName
String

Nome di un file firmato PKCS7.The name of a PKCS7 signed file.

password
String

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro fileName è null.The fileName parameter is null.

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class. Chiamando il costruttore con la password corretta, la chiave privata viene decrittografata e salvata in un contenitore di chiavi.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per fileName, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

FileIOPermission
autorizzazione per la lettura del file descritto dal parametro fileName.for permission to read the file described by the fileName parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: ReadAssociated enumeration: Read

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(String, SecureString)

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe X509Certificate usando un nome di file di certificato e una password.Initializes a new instance of the X509Certificate class using a certificate file name and a password.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString)

Parametri

fileName
String

Nome di un file di certificato.The name of a certificate file.

password
SecureString

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro fileName è null.The fileName parameter is null.

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class. Chiamando il costruttore con la password corretta, la chiave privata viene decrittografata e salvata in un contenitore di chiavi.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per fileName, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

FileIOPermission
autorizzazione per la lettura del file descritto dal parametro fileName.for permission to read the file described by the fileName parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: ReadAssociated enumeration: Read

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe X509Certificate usando un oggetto SerializationInfo e una struttura StreamingContext.Initializes a new instance of the X509Certificate class using a SerializationInfo object and a StreamingContext structure.

public:
 X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
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
Public Sub New (info As SerializationInfo, context As StreamingContext)

Parametri

info
SerializationInfo

Oggetto SerializationInfo che descrive le informazioni di serializzazione.A SerializationInfo object that describes serialization information.

context
StreamingContext

Struttura StreamingContext che descrive le modalità di esecuzione della serializzazione.A StreamingContext structure that describes how serialization should be performed.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

X509Certificate(String, String, X509KeyStorageFlags)

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7, una password per accedere al certificato e un flag di archiviazione chiavi.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file, a password to access the certificate, and a key storage flag.

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

Parametri

fileName
String

Nome di un file firmato PKCS7.The name of a PKCS7 signed file.

password
String

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.A bitwise combination of the enumeration values that control where and how to import the certificate.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro fileName è null.The fileName parameter is null.

Commenti

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per fileName, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

FileIOPermission
autorizzazione per la lettura del file descritto dal parametro fileName.for permission to read the file described by the fileName parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: ReadAssociated enumeration: Read

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(Byte[], SecureString)

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte e una password.Initializes a new instance of the X509Certificate class using a byte array and a password.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString)

Parametri

rawData
Byte[]

Matrice di byte contenente i dati di un certificato X.509.A byte array that contains data from an X.509 certificate.

password
SecureString

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro rawData è null.The rawData parameter is null.

-oppure--or- La lunghezza del parametro rawData è 0.The length of the rawData parameter is 0.

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per rawData, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

SecurityPermission
per la possibilità di chiamare codice non gestito.for the ability to call unmanaged code. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(String)

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

public:
 X509Certificate(System::String ^ fileName);
public X509Certificate (string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String)

Parametri

fileName
String

Nome di un file firmato PKCS7.The name of a PKCS7 signed file.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro fileName è null.The fileName parameter is null.

Esempi

Nell'esempio seguente viene caricato un certificato X. 509 da un file, viene chiamato il metodo ToString e i risultati vengono visualizzati nella console.The following example loads an X.509 certificate from a file, calls the ToString method, and displays the results to the 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

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per fileName, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

FileIOPermission
autorizzazione per la lettura del file descritto dal parametro fileName.for permission to read the file described by the fileName parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: ReadAssociated enumeration: Read

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(X509Certificate)

Inizializza una nuova istanza della classe X509Certificate usando un'altra classe X509Certificate.Initializes a new instance of the X509Certificate class using another X509Certificate class.

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (cert As X509Certificate)

Parametri

cert
X509Certificate

Classe X509Certificate dalla quale inizializzare questa classe.A X509Certificate class from which to initialize this class.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro cert è null.The value of the cert parameter is null.

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

X509Certificate(IntPtr)

Inizializza una nuova istanza della classe X509Certificate tramite un handle per una struttura PCCERT_CONTEXT non gestita.Initializes a new instance of the X509Certificate class using a handle to an unmanaged PCCERT_CONTEXT structure.

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

Parametri

handle
IntPtr

Handle per una struttura PCCERT_CONTEXT non gestita.A handle to an unmanaged PCCERT_CONTEXT structure.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il parametro dell'handle non rappresenta una struttura PCCERT_CONTEXT valida.The handle parameter does not represent a valid PCCERT_CONTEXT structure.

Commenti

Questo costruttore crea un nuovo oggetto X509Certificate usando un handle per il contesto del certificato dell'API di crittografia Microsoft, PCCERT_CONTEXT.This constructor creates a new X509Certificate object using a handle for the Microsoft Cryptographic API certificate context, PCCERT_CONTEXT.

Importante

Questo costruttore crea una copia del contesto del certificato.This constructor creates a copy of the certificate context. Non presupporre che la struttura del contesto passata al costruttore sia valida. potrebbe essere stato rilasciato.Do not assume that the context structure you passed to the constructor is valid; it may have been released. È possibile ottenere una copia della struttura di PCCERT_CONTEXT corrente dalla proprietà Handle, ma è valida solo per il ciclo di vita dell'oggetto X509Certificate.You can get a copy of the current PCCERT_CONTEXT structure from the Handle property, but it is valid only during the lifetime of the X509Certificate object.

Sicurezza

SecurityCriticalAttribute
Richiede l'attendibilità totale per il chiamante immediato.requires full trust for the immediate caller. Questa classe non può essere utilizzata da codice parzialmente attendibile o trasparente.This class cannot be used by partially trusted or transparent code.

InheritanceDemand
per la capacità degli eredi di eseguire codice non gestito.for the ability of inheritors to execute unmanaged code. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate(Byte[])

Inizializza una nuova istanza della classe X509Certificate definita da una sequenza di byte che rappresenta un certificato X.509v3.Initializes a new instance of the X509Certificate class defined from a sequence of bytes representing an X.509v3 certificate.

public:
 X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate (byte[] data);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (data As Byte())

Parametri

data
Byte[]

Matrice di byte contenente i dati di un certificato X.509.A byte array containing data from an X.509 certificate.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro rawData è null.The rawData parameter is null.

-oppure--or- La lunghezza del parametro rawData è 0.The length of the rawData parameter is 0.

Esempi

Nell'esempio seguente viene caricato un file di certificato X. 509 in un oggetto X509Certificate, viene esportato il certificato come matrice di byte e quindi viene importata la matrice di byte in un altro oggetto X509Certificate.The following example loads an X.509 certificate file into an X509Certificate object, exports the certificate as a byte array, and then imports the byte array into another X509Certificate object.

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

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per data, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for data, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

X509Certificate(Byte[], String)

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte e una password.Initializes a new instance of the X509Certificate class using a byte array and a password.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate (byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String)

Parametri

rawData
Byte[]

Matrice di byte contenente i dati di un certificato X.509.A byte array containing data from an X.509 certificate.

password
String

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

Eccezioni

Si è verificato un errore relativo al certificato.An error with the certificate occurs. Ad esempio:For example:

- Il file del certificato non esiste.- The certificate file does not exist.

- Il certificato non è valido.- The certificate is invalid.

- La password del certificato non è corretta.- The certificate's password is incorrect.

Il valore del parametro rawData è null.The rawData parameter is null.

-oppure--or- La lunghezza del parametro rawData è 0.The length of the rawData parameter is 0.

Commenti

ASN. 1 DER è l'unico formato di certificato supportato da questa classe.ASN.1 DER is the only certificate format supported by this class.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Se si crea un certificato di X509Certificate specificando un archivio file firmato PKCS7 per rawData, il X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno dei certificati presenti nell'archivio.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Sicurezza

SecurityPermission
per la possibilità di chiamare codice non gestito.for the ability to call unmanaged code. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

KeyContainerPermission
autorizzazione per la creazione di un contenitore di chiavi.for permission to create a key container. Azione di sicurezza: Demand.Security action: Demand. Enumerazione associata: CreateAssociated enumeration: Create

Si applica a