X509Certificate Classe

Definizione

Fornisce metodi che semplificano l'utilizzo dei certificati X.509v3.Provides methods that help you use X.509 v.3 certificates.

public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type X509Certificate = class
    interface IDeserializationCallback
    interface ISerializable
    interface IDisposable
Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable
Ereditarietà
X509Certificate
Derivato
Attributi
Implementazioni

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.

Per la maggior parte degli scenari, è consigliabile usare invece la classe X509Certificate2.For most scenarios, you should use the X509Certificate2 class instead.

Importante

A partire dalla .NET Framework 4.6.NET Framework 4.6, questo tipo implementa l'interfaccia IDisposable.Starting with the .NET Framework 4.6.NET Framework 4.6, this type implements the IDisposable interface. Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente.When you have finished using the type, you should dispose of it either directly or indirectly. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic.To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Per le app destinate a .NET Framework 4.5.2.NET Framework 4.5.2 e versioni precedenti, la classe X509Certificate non implementa l'interfaccia IDisposable e pertanto non dispone di un metodo Dispose.For apps that target the .NET Framework 4.5.2.NET Framework 4.5.2 and earlier versions, the X509Certificate class does not implement the IDisposable interface and therefore does not have a Dispose method.

Costruttori

X509Certificate()

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

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[], 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(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(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(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(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(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)

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(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(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(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, 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(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.

Proprietà

Handle

Ottiene un handle per un contesto di certificato dell'API di crittografia Microsoft descritto da una struttura PCCERT_CONTEXT non gestita.Gets a handle to a Microsoft Cryptographic API certificate context described by an unmanaged PCCERT_CONTEXT structure.

Issuer

Ottiene il nome dell'autorità di certificazione che ha emesso il certificato X.509v3.Gets the name of the certificate authority that issued the X.509v3 certificate.

Subject

Ottiene il nome distinto dell'oggetto dal certificato.Gets the subject distinguished name from the certificate.

Metodi

CreateFromCertFile(String)

Crea un certificato X.509v3 dal file firmato PKCS7 specificato.Creates an X.509v3 certificate from the specified PKCS7 signed file.

CreateFromSignedFile(String)

Crea un certificato X.509v3 dal file firmato specificato.Creates an X.509v3 certificate from the specified signed file.

Dispose()

Rilascia tutte le risorse usate dall'oggetto X509Certificate corrente.Releases all resources used by the current X509Certificate object.

Dispose(Boolean)

Rilascia tutte le risorse non gestite usate da questo oggetto X509Certificate e, facoltativamente, le risorse gestite.Releases all of the unmanaged resources used by this X509Certificate and optionally releases the managed resources.

Equals(Object)

Confronta due oggetti X509Certificate per stabilirne l'uguaglianza.Compares two X509Certificate objects for equality.

Equals(X509Certificate)

Confronta due oggetti X509Certificate per stabilirne l'uguaglianza.Compares two X509Certificate objects for equality.

Export(X509ContentType)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

Export(X509ContentType, SecureString)

Esporta l'oggetto X509Certificate corrente in una matrice di byte usando il formato specificato e una password.Exports the current X509Certificate object to a byte array using the specified format and a 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.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values, and using the specified password.

FormatDate(DateTime)

Converte la data e l'ora specificate in una stringa.Converts the specified date and time to a string.

GetCertHash()

Restituisce il valore hash del certificato X.509v3 sotto forma di matrice di byte.Returns the hash value for the X.509v3 certificate as an array of bytes.

GetCertHash(HashAlgorithmName)

Restituisce il valore hash per il certificato x.509v3 calcolato usando l'algoritmo di hash di crittografia specificato.Returns the hash value for the X.509v3 certificate that is computed by using the specified cryptographic hash algorithm.

GetCertHashString()

Restituisce il valore hash SHA1 del certificato X.509v3 sotto forma di stringa esadecimale.Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string.

GetCertHashString(HashAlgorithmName)

Restituisce una stringa esadecimale contenente il valore hash per il certificato x.509v3 calcolato usando l'algoritmo di hash di crittografia specificato.Returns a hexadecimal string containing the hash value for the X.509v3 certificate computed using the specified cryptographic hash algorithm.

GetEffectiveDateString()

Restituisce la data effettiva del certificato X.509v3.Returns the effective date of this X.509v3 certificate.

GetExpirationDateString()

Restituisce la data di scadenza del certificato X.509v3.Returns the expiration date of this X.509v3 certificate.

GetFormat()

Restituisce il nome del formato del certificato X.509v3.Returns the name of the format of this X.509v3 certificate.

GetHashCode()

Restituisce il codice hash del certificato X.509v3 sotto forma di intero.Returns the hash code for the X.509v3 certificate as an integer.

GetIssuerName()

Restituisce il nome dell'autorità di certificazione che ha emesso il certificato X.509v3.Returns the name of the certification authority that issued the X.509v3 certificate.

GetKeyAlgorithm()

Restituisce le informazioni dell'algoritmo delle chiavi per il certificato X.509v3 sotto forma di stringa.Returns the key algorithm information for this X.509v3 certificate as a string.

GetKeyAlgorithmParameters()

Restituisce i parametri dell'algoritmo delle chiavi per il certificato X.509v3 sotto forma di matrice di byte.Returns the key algorithm parameters for the X.509v3 certificate as an array of bytes.

GetKeyAlgorithmParametersString()

Restituisce i parametri dell'algoritmo delle chiavi per il certificato X.509v3 sotto forma di stringa esadecimale.Returns the key algorithm parameters for the X.509v3 certificate as a hexadecimal string.

GetName()

Restituisce il nome dell'oggetto Principal a cui è stato rilasciato il certificato.Returns the name of the principal to which the certificate was issued.

GetPublicKey()

Restituisce la chiave pubblica del certificato X.509v3 sotto forma di matrice di byte.Returns the public key for the X.509v3 certificate as an array of bytes.

GetPublicKeyString()

Restituisce la chiave pubblica del certificato X.509v3 sotto forma di stringa esadecimale.Returns the public key for the X.509v3 certificate as a hexadecimal string.

GetRawCertData()

Restituisce i dati non elaborati dell'intero certificato X.509v3 sotto forma di matrice di byte.Returns the raw data for the entire X.509v3 certificate as an array of bytes.

GetRawCertDataString()

Restituisce i dati non elaborati dell'intero certificato X.509v3 sotto forma di stringa esadecimale.Returns the raw data for the entire X.509v3 certificate as a hexadecimal string.

GetSerialNumber()

Restituisce il numero di serie del certificato X.509v3 sotto forma di matrice di byte in ordine Little Endian.Returns the serial number of the X.509v3 certificate as an array of bytes in little-endian order.

GetSerialNumberString()

Restituisce il numero di serie del certificato X.509v3 sotto forma di stringa esadecimale Little Endian.Returns the serial number of the X.509v3 certificate as a little-endian hexadecimal string .

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
Import(Byte[])

Popola l'oggetto X509Certificate con i dati di una matrice di byte.Populates the X509Certificate object with data from a byte array.

Import(Byte[], SecureString, X509KeyStorageFlags)

Popola un oggetto X509Certificate usando i dati di una matrice di byte, una password e un flag di archiviazione delle chiavi.Populates an X509Certificate object using data from a byte array, a password, and a key storage flag.

Import(Byte[], String, X509KeyStorageFlags)

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.Populates the X509Certificate object using data from a byte array, a password, and flags for determining how the private key is imported.

Import(String)

Popola l'oggetto X509Certificate con le informazioni di un file di certificato.Populates the X509Certificate object with information from a certificate file.

Import(String, SecureString, X509KeyStorageFlags)

Popola un oggetto X509Certificate con le informazioni di un file di certificato, una password e un flag di archiviazione delle chiavi.Populates an X509Certificate object with information from a certificate file, a password, and a key storage flag.

Import(String, String, X509KeyStorageFlags)

Popola l'oggetto X509Certificate con le informazioni di un file di certificato, una password e un valore X509KeyStorageFlags.Populates the X509Certificate object with information from a certificate file, a password, and a X509KeyStorageFlags value.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Reset()

Reimposta lo stato dell'oggetto X509Certificate2.Resets the state of the X509Certificate2 object.

ToString()

Restituisce una rappresentazione di stringa dell'oggetto X509Certificate corrente.Returns a string representation of the current X509Certificate object.

ToString(Boolean)

Restituisce una rappresentazione di stringa dell'oggetto X509Certificate corrente insieme a informazioni aggiuntive, se specificate.Returns a string representation of the current X509Certificate object, with extra information, if specified.

TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Implementazioni dell'interfaccia esplicita

IDeserializationCallback.OnDeserialization(Object)

Implementa l'interfaccia ISerializable e viene richiamato dall'evento di deserializzazione al termine della deserializzazione.Implements the ISerializable interface and is called back by the deserialization event when deserialization is complete.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Ottiene le informazioni di serializzazione con tutti i dati necessari per ricreare un'istanza dell'oggetto X509Certificate corrente.Gets serialization information with all the data needed to recreate an instance of the current X509Certificate object.

Si applica a