X509Certificate Classe

Definizione

Fornisce metodi che semplificano l'utilizzo dei certificati X.509v3.

public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
public class X509Certificate : IDisposable
[System.Serializable]
public class X509Certificate
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
Ereditarietà
X509Certificate
Derivato
Attributi
Implementazioni

Esempio

L'esempio seguente carica un certificato X.509 da un file, chiama il ToString metodo e visualizza i risultati nella console.

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

Commenti

ASN.1 DER è l'unico formato di certificato supportato da questa classe.

Per la maggior parte degli scenari, è consigliabile usare invece la X509Certificate2 classe.

Importante

A partire da .NET Framework 4.6, questo tipo implementa l'interfaccia IDisposable . Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic. Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.

Per le app destinate a .NET Framework 4.5.2 e versioni precedenti, la X509Certificate classe non implementa l'interfaccia IDisposable e pertanto non dispone di un Dispose metodo.

Costruttori

X509Certificate()
Obsoleti.
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate.

X509Certificate(Byte[])
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate definita da una sequenza di byte che rappresenta un certificato X.509v3.

X509Certificate(Byte[], SecureString)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte e una password.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte, una password e un flag di archiviazione delle chiavi.

X509Certificate(Byte[], String)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte e una password.

X509Certificate(Byte[], String, X509KeyStorageFlags)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando una matrice di byte, una password e un flag di archiviazione delle chiavi.

X509Certificate(IntPtr)

Inizializza una nuova istanza della classe X509Certificate tramite un handle per una struttura PCCERT_CONTEXT non gestita.

X509Certificate(SerializationInfo, StreamingContext)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando un oggetto SerializationInfo e una struttura StreamingContext.

X509Certificate(String)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7.

X509Certificate(String, SecureString)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando un nome di file di certificato e una password.

X509Certificate(String, SecureString, X509KeyStorageFlags)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando un nome di file di certificato, una password e un flag di archiviazione delle chiavi.

X509Certificate(String, String)
Obsoleti.

Inizializza una nuova istanza della classe X509Certificate usando il nome di un file firmato PKCS7 e una password per accedere al certificato.

X509Certificate(String, String, X509KeyStorageFlags)
Obsoleti.

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.

X509Certificate(X509Certificate)

Inizializza una nuova istanza della classe X509Certificate usando un'altra classe X509Certificate.

Proprietà

Handle

Ottiene un handle per un contesto di certificato dell'API di crittografia Microsoft descritto da una struttura PCCERT_CONTEXT non gestita.

Issuer

Ottiene il nome dell'autorità di certificazione che ha emesso il certificato X.509v3.

SerialNumberBytes

Ottiene la rappresentazione big-endian del numero di serie del certificato.

Subject

Ottiene il nome distinto dell'oggetto dal certificato.

Metodi

CreateFromCertFile(String)
Obsoleti.

Crea un certificato X.509v3 dal file firmato PKCS7 specificato.

CreateFromSignedFile(String)
Obsoleti.

Crea un certificato X.509v3 dal file firmato specificato.

Dispose()

Rilascia tutte le risorse usate dall'oggetto X509Certificate corrente.

Dispose(Boolean)

Rilascia tutte le risorse non gestite usate da questo oggetto X509Certificate e, facoltativamente, le risorse gestite.

Equals(Object)

Confronta due oggetti X509Certificate per stabilirne l'uguaglianza.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Equals(X509Certificate)

Confronta due oggetti X509Certificate per stabilirne l'uguaglianza.

Export(X509ContentType)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType.

Export(X509ContentType, SecureString)

Esporta l'oggetto X509Certificate corrente in una matrice di byte usando il formato specificato e una password.

Export(X509ContentType, String)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType e usando la password specificata.

FormatDate(DateTime)

Converte la data e l'ora specificate in una stringa.

GetCertHash()

Restituisce il valore hash del certificato X.509v3 sotto forma di matrice di byte.

GetCertHash(HashAlgorithmName)

Restituisce il valore hash per il certificato x.509v3 calcolato usando l'algoritmo di hash di crittografia specificato.

GetCertHashString()

Restituisce il valore hash SHA1 per il certificato X.509v3 come stringa esadecimale.

GetCertHashString(HashAlgorithmName)

Restituisce una stringa esadecimale contenente il valore hash per il certificato x.509v3 calcolato usando l'algoritmo di hash di crittografia specificato.

GetEffectiveDateString()

Restituisce la data effettiva del certificato X.509v3.

GetExpirationDateString()

Restituisce la data di scadenza del certificato X.509v3.

GetFormat()

Restituisce il nome del formato di questo certificato X.509v3.

GetHashCode()

Restituisce il codice hash del certificato X.509v3 sotto forma di intero.

GetIssuerName()
Obsoleti.
Obsoleti.
Obsoleti.

Restituisce il nome dell'autorità di certificazione che ha emesso il certificato X.509v3.

GetKeyAlgorithm()

Restituisce le informazioni dell'algoritmo a chiave per il certificato X.509v3 sotto forma di stringa.

GetKeyAlgorithmParameters()

Restituisce i parametri dell'algoritmo delle chiavi per il certificato X.509v3 sotto forma di matrice di byte.

GetKeyAlgorithmParametersString()

Restituisce i parametri dell'algoritmo a chiave per il certificato X.509v3 sotto forma di stringa esadecimale.

GetName()
Obsoleti.
Obsoleti.
Obsoleti.

Restituisce il nome dell'oggetto Principal a cui è stato rilasciato il certificato.

GetPublicKey()

Restituisce la chiave pubblica del certificato X.509v3 sotto forma di matrice di byte.

GetPublicKeyString()

Restituisce la chiave pubblica del certificato X.509v3 sotto forma di stringa esadecimale.

GetRawCertData()

Restituisce i dati non elaborati dell'intero certificato X.509v3 sotto forma di matrice di byte.

GetRawCertDataString()

Restituisce i dati non elaborati dell'intero certificato X.509v3 sotto forma di stringa esadecimale.

GetSerialNumber()

Restituisce il numero di serie del certificato X.509v3 sotto forma di matrice di byte in ordine Little Endian.

GetSerialNumberString()

Restituisce il numero di serie del certificato X.509v3 sotto forma di stringa esadecimale Little Endian.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Import(Byte[])
Obsoleti.
Obsoleti.

Popola l'oggetto X509Certificate con i dati di una matrice di byte.

Import(Byte[], SecureString, X509KeyStorageFlags)
Obsoleti.
Obsoleti.

Popola un oggetto X509Certificate usando i dati di una matrice di byte, una password e un flag di archiviazione delle chiavi.

Import(Byte[], String, X509KeyStorageFlags)
Obsoleti.
Obsoleti.

Popola l'oggetto X509Certificate usando i dati di una matrice di byte, una password e flag per determinare la modalità di importazione della chiave privata.

Import(String)
Obsoleti.
Obsoleti.

Popola l'oggetto X509Certificate con le informazioni di un file di certificato.

Import(String, SecureString, X509KeyStorageFlags)
Obsoleti.
Obsoleti.

Popola un oggetto X509Certificate con le informazioni di un file di certificato, una password e un flag di archiviazione delle chiavi.

Import(String, String, X509KeyStorageFlags)
Obsoleti.
Obsoleti.

Popola l'oggetto X509Certificate con le informazioni di un file di certificato, una password e un valore X509KeyStorageFlags.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
Reset()

Reimposta lo stato dell'oggetto X509Certificate2.

ToString()

Restituisce una rappresentazione di stringa dell'oggetto X509Certificate corrente.

ToString(Boolean)

Restituisce una rappresentazione di stringa dell'oggetto X509Certificate corrente insieme a informazioni aggiuntive, se specificate.

TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Tenta di produrre un'identificazione personale per il certificato eseguendo l'hash della rappresentazione codificata del certificato con l'algoritmo hash specificato.

Implementazioni dell'interfaccia esplicita

IDeserializationCallback.OnDeserialization(Object)

Implementa l'interfaccia ISerializable e viene richiamato dall'evento di deserializzazione al termine della deserializzazione.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Ottiene le informazioni di serializzazione con tutti i dati necessari per ricreare un'istanza dell'oggetto X509Certificate corrente.

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1