X509Certificate2 Costruttori

Definizione

Spazio dei nomi:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Inizializza una nuova istanza della classe X509Certificate2.

Overload

X509Certificate2()	Obsoleti. Inizializza una nuova istanza della classe X509Certificate2.
X509Certificate2(String, String, X509KeyStorageFlags)	Inizializza una nuova istanza della classe X509Certificate2 utilizzando un nome di file di certificato, una password necessaria per accedere al certificato e un flag di archiviazione delle chiavi.
X509Certificate2(String, SecureString, X509KeyStorageFlags)	Inizializza una nuova istanza della classe X509Certificate2 usando un nome di file di certificato, una password e un flag di archiviazione delle chiavi.
X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)	Inizializza una nuova istanza della classe X509Certificate2 usando un nome di file di certificato, una password e un flag di archiviazione delle chiavi.
X509Certificate2(Byte[], String, X509KeyStorageFlags)	Inizializza una nuova istanza della classe X509Certificate2 usando una matrice di byte, una password e un flag di archiviazione delle chiavi.
X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)	Inizializza una nuova istanza della classe X509Certificate2 usando una matrice di byte, una password e un flag di archiviazione delle chiavi.
X509Certificate2(String, String)	Inizializza una nuova istanza della classe X509Certificate2 utilizzando un nome di file di certificato e una password necessaria per accedere al certificato.
X509Certificate2(String, SecureString)	Inizializza una nuova istanza della classe X509Certificate2 usando un nome di file di certificato e una password.
X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)	Inizializza una nuova istanza della classe X509Certificate2 usando i dati del certificato, una password e flag di archiviazione delle chiavi.
X509Certificate2(Byte[], String)	Inizializza una nuova istanza della classe X509Certificate2 usando una matrice di byte e una password.
X509Certificate2(Byte[], SecureString)	Inizializza una nuova istanza della classe X509Certificate2 usando una matrice di byte e una password.
X509Certificate2(String)	Inizializza una nuova istanza della classe X509Certificate2 tramite un nome di file di certificato.
X509Certificate2(X509Certificate)	Inizializza una nuova istanza della classe X509Certificate2 utilizzando un oggetto X509Certificate.
X509Certificate2(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della classe X509Certificate2 utilizzando le informazioni di serializzazione e del contesto di flusso specificate.
X509Certificate2(ReadOnlySpan<Byte>)	Inizializza una nuova istanza della classe X509Certificate2 dai dati del certificato.
X509Certificate2(IntPtr)	Inizializza una nuova istanza della classe X509Certificate2 utilizzando un handle non gestito.
X509Certificate2(Byte[])	Inizializza una nuova istanza della classe X509Certificate2 utilizzando le informazioni ottenute da una matrice di byte.

X509Certificate2()

Origine:

X509Certificate2.cs

Attenzione

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Inizializza una nuova istanza della classe X509Certificate2.

public:
 X509Certificate2();

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 ();

Public Sub New ()

Attributi

ObsoleteAttribute UnsupportedOSPlatformAttribute

Esempio

L'esempio di codice seguente apre l'archivio certificati utente corrente, seleziona solo i certificati attivi e quindi consente all'utente di selezionare uno o più certificati. L'esempio scrive quindi le informazioni sul certificato nella console.

#using <System.dll>
#using <System.Security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store ^ store = gcnew X509Store( "MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection ^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection ^ fcollection = dynamic_cast<X509Certificate2Collection^>(collection->Find( X509FindType::FindByTimeValid, DateTime::Now, false ));
      X509Certificate2Collection ^ scollection = X509Certificate2UI::SelectFromCollection(fcollection, "Test Certificate Select","Select a certificate from the following list to get information on that certificate",X509SelectionFlag::MultiSelection);
      Console::WriteLine( "Number of certificates: {0}{1}", scollection->Count, Environment::NewLine );
      System::Collections::IEnumerator^ myEnum = scollection->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
         array<Byte>^rawdata = x509->RawData;
         Console::WriteLine( "Content Type: {0}{1}", X509Certificate2::GetCertContentType( rawdata ), Environment::NewLine );
         Console::WriteLine( "Friendly Name: {0}{1}", x509->FriendlyName, Environment::NewLine );
         Console::WriteLine( "Certificate Verified?: {0}{1}", x509->Verify(), Environment::NewLine );
         Console::WriteLine( "Simple Name: {0}{1}", x509->GetNameInfo( X509NameType::SimpleName, true ), Environment::NewLine );
         Console::WriteLine( "Signature Algorithm: {0}{1}", x509->SignatureAlgorithm->FriendlyName, Environment::NewLine );
         Console::WriteLine( "Private Key: {0}{1}", x509->PrivateKey->ToXmlString( false ), Environment::NewLine );
         Console::WriteLine( "Public Key: {0}{1}", x509->PublicKey->Key->ToXmlString( false ), Environment::NewLine );
         Console::WriteLine( "Certificate Archived?: {0}{1}", x509->Archived, Environment::NewLine );
         Console::WriteLine( "Length of Raw Data: {0}{1}", x509->RawData->Length, Environment::NewLine );
         x509->Reset();
      }
      store->Close();
   }
   catch ( CryptographicException^ ) 
   {
      Console::WriteLine( "Information could not be written out for this certificate." );
   }

}

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

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

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

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

Imports System.Security.Cryptography
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates

Class CertSelect

    Shared Sub Main()

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

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

        store.Close()
    End Sub
End Class

Commenti

Questo costruttore crea un oggetto vuoto X509Certificate2 , a differenza degli altri costruttori per questa classe che usano informazioni sul certificato da una matrice di byte, un puntatore o un file di certificato.

X509Certificate2(String, String, X509KeyStorageFlags)

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 utilizzando un nome di file di certificato, una password necessaria per accedere al certificato e un flag di archiviazione delle chiavi.

public:
 X509Certificate2(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parametri

fileName

String

Nome di un file di certificato.

password

String

Password necessaria per accedere ai dati del certificato X.509.

keyStorageFlags

X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file del certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando un nome file di certificato, una password necessaria per accedere al certificato e un flag di archiviazione delle chiavi.

Importante

Non impostare mai come hardcoded una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (Disassembler IL), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un X509Certificate2 certificato specificando un archivio file firmato PKCS7 per fileName, X509Certificate2 viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

X509Certificate2(String, SecureString, X509KeyStorageFlags)

Origine:

X509Certificate2.cs

Importante

Questa API non è conforme a CLS.

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

public:
 X509Certificate2(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parametri

fileName

String

Nome di un file di certificato.

password

SecureString

Password necessaria per accedere ai dati del certificato X.509.

keyStorageFlags

X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.

Attributi

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file del certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Se si crea un X509Certificate certificato specificando un archivio file firmato PKCS7 per fileName, X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)

Origine:

X509Certificate2.cs

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

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (fileName As String, password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet)

Parametri

fileName

String

Nome di un file di certificato.

password

ReadOnlySpan<Char>

Password necessaria per accedere ai dati del certificato X.509.

keyStorageFlags

X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file del certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Importante

Non impostare mai come hardcoded una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (Disassembler IL), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un X509Certificate2 certificato specificando un archivio file firmato PKCS7 per fileName, X509Certificate2 viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Origine:

X509Certificate2.cs

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

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Parametri

rawData

Byte[]

Matrice di byte contenente i dati di un certificato X.509.

password

String

Password necessaria per accedere ai dati del certificato X.509.

keyStorageFlags

X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file del certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando una matrice di byte, una password necessaria per accedere ai dati del certificato e un flag di archiviazione delle chiavi. Viene usato con i file PKCS12 (PFX) che contengono la chiave privata del certificato. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un provider di servizi di crittografia (CSP) dell'API crittografica Microsoft.

Importante

Non impostare mai come hardcoded una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (Disassembler IL), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un X509Certificate2 certificato specificando un archivio file firmato PKCS7 per rawData, X509Certificate2 viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Origine:

X509Certificate2.cs

Importante

Questa API non è conforme a CLS.

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

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2

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.

password

SecureString

Password necessaria per accedere ai dati del certificato X.509.

keyStorageFlags

X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.

Attributi

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore viene usato con i file PKCS12 (PFX) che contengono la chiave privata del certificato. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un provider di servizi di crittografia API crittografica Microsoft.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un certificato specificando un X509Certificate archivio file firmato PKCS7 per rawData, viene X509Certificate creato per il certificato che ha firmato l'archivio anziché per uno dei certificati all'interno dell'archivio.

X509Certificate2(String, String)

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 utilizzando un nome di file di certificato e una password necessaria per accedere al certificato.

public:
 X509Certificate2(System::String ^ fileName, System::String ^ password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName, string? password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (fileName As String, password As String)

Parametri

fileName

String

Nome di un file di certificato.

password

String

Password necessaria per accedere ai dati del certificato X.509.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando un nome file di certificato e una password necessaria per accedere al certificato. Viene usato con i file PKCS12 (PFX) che contengono la chiave privata del certificato. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un contenitore di chiavi.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un certificato specificando un X509Certificate2 archivio file firmato PKCS7 per fileName, viene X509Certificate2 creato per il certificato che ha firmato l'archivio anziché per uno dei certificati all'interno dell'archivio.

X509Certificate2(String, SecureString)

Origine:

X509Certificate2.cs

Importante

Questa API non è conforme a CLS.

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

public:
 X509Certificate2(System::String ^ fileName, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (fileName As String, password As SecureString)

Parametri

fileName

String

Nome di un file di certificato.

password

SecureString

Password necessaria per accedere ai dati del certificato X.509.

Attributi

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore viene usato con i file PKCS12 (PFX) che contengono la chiave privata del certificato. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un contenitore di chiavi.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un certificato specificando un X509Certificate archivio file firmato PKCS7 per fileName, viene X509Certificate creato per il certificato che ha firmato l'archivio anziché per uno dei certificati all'interno dell'archivio.

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

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 usando i dati del certificato, una password e flag di archiviazione delle chiavi.

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (ReadOnlySpan<byte> rawData, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : ReadOnlySpan<byte> * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (rawData As ReadOnlySpan(Of Byte), password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet)

Parametri

rawData

ReadOnlySpan<Byte>

Dati del certificato da elaborare.

password

ReadOnlySpan<Char>

Password richiesta per accedere ai dati del certificato.

keyStorageFlags

X509KeyStorageFlags

Combinazione bit per bit dei valori di enumerazione che specificano la posizione e la modalità di importazione del certificato.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato.

X509Certificate2(Byte[], String)

Origine:

X509Certificate2.cs

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

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::String ^ password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (byte[] rawData, string? password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (rawData As Byte(), password As String)

Parametri

rawData

Byte[]

Matrice di byte contenente i dati di un certificato X.509.

password

String

Password necessaria per accedere ai dati del certificato X.509.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando una matrice di byte e una password necessaria per accedere ai dati del certificato. Viene usato con i file PKCS12 (PFX) che contengono la chiave privata del certificato. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un contenitore di chiavi.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un certificato specificando un X509Certificate2 archivio file firmato PKCS7 per rawData, viene X509Certificate2 creato per il certificato che ha firmato l'archivio anziché per uno dei certificati all'interno dell'archivio.

X509Certificate2(Byte[], SecureString)

Origine:

X509Certificate2.cs

Importante

Questa API non è conforme a CLS.

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

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (byte[] rawData, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (rawData As Byte(), password As SecureString)

Parametri

rawData

Byte[]

Matrice di byte contenente i dati di un certificato X.509.

password

SecureString

Password necessaria per accedere ai dati del certificato X.509.

Attributi

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore viene usato con i file PKCS12 (PFX) che contengono la chiave privata del certificato. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un contenitore di chiavi.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Se si crea un certificato specificando un X509Certificate archivio file firmato PKCS7 per rawData, viene X509Certificate creato per il certificato che ha firmato l'archivio anziché per uno dei certificati all'interno dell'archivio.

X509Certificate2(String)

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 tramite un nome di file di certificato.

public:
 X509Certificate2(System::String ^ fileName);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (fileName As String)

Parametri

fileName

String

Nome di un file di certificato.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando un nome file di certificato. Supporta la codifica binaria (DER) o la codifica Base64.

Se si crea un certificato specificando un X509Certificate2 archivio file firmato PKCS7 per fileName, viene X509Certificate2 creato per il certificato che ha firmato l'archivio anziché per uno dei certificati all'interno dell'archivio.

X509Certificate2(X509Certificate)

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 utilizzando un oggetto X509Certificate.

public:
 X509Certificate2(System::Security::Cryptography::X509Certificates::X509Certificate ^ certificate);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (System.Security.Cryptography.X509Certificates.X509Certificate certificate);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (certificate As X509Certificate)

Parametri

certificate

X509Certificate

Oggetto X509Certificate.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file di certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo metodo crea una nuova istanza della X509Certificate2 classe usando un X509Certificate oggetto .

X509Certificate2(SerializationInfo, StreamingContext)

Origine:

X509Certificate2.cs

Attenzione

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inizializza una nuova istanza della classe X509Certificate2 utilizzando le informazioni di serializzazione e del contesto di flusso specificate.

protected:
 X509Certificate2(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected X509Certificate2 (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate2

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parametri

info

SerializationInfo

Informazioni di serializzazione necessarie per deserializzare la nuova classe X509Certificate2.

context

StreamingContext

Informazioni contestuali sull'origine del flusso da deserializzare.

Attributi

ObsoleteAttribute

Eccezioni

PlatformNotSupportedException

Solo .NET Core e .NET 5+: In tutti i casi.

X509Certificate2(ReadOnlySpan<Byte>)

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 dai dati del certificato.

public:
 X509Certificate2(ReadOnlySpan<System::Byte> rawData);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (ReadOnlySpan<byte> rawData);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : ReadOnlySpan<byte> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (rawData As ReadOnlySpan(Of Byte))

Parametri

rawData

ReadOnlySpan<Byte>

Dati del certificato da elaborare.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato.

X509Certificate2(IntPtr)

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 utilizzando un handle non gestito.

public:
 X509Certificate2(IntPtr handle);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (IntPtr handle);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (handle As IntPtr)

Parametri

handle

IntPtr

nativeint

Puntatore a un contesto di certificato in codice non gestito. La struttura C è denominata PCCERT_CONTEXT.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file del certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando un handle per il contesto del certificato dell'API di crittografia Microsoft, PCCERT_CONTEXT. Si noti che il chiamante immediato di questo costruttore richiede l'autorizzazione del codice non gestito.

Importante

Il costruttore crea una copia del contesto del certificato. Non presupporre che la struttura di contesto passata al costruttore sia valida; potrebbe essere stato rilasciato. È possibile ottenere una copia della struttura corrente PCCERT_CONTEXT dalla Handle proprietà , ma è valida solo durante la durata dell'oggetto X509Certificate2 .

X509Certificate2(Byte[])

Origine:

X509Certificate2.cs

Inizializza una nuova istanza della classe X509Certificate2 utilizzando le informazioni ottenute da una matrice di byte.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (byte[] rawData);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Sub New (rawData As Byte())

Parametri

rawData

Byte[]

Matrice di byte contenente i dati di un certificato X.509.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Si è verificato un errore relativo al certificato. Esempio:

• Il file del certificato non esiste.

• Il certificato non è valido.

• La password del certificato non è corretta.

Commenti

Questo costruttore crea un nuovo X509Certificate2 oggetto usando le informazioni sul certificato da una matrice di byte. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64. La matrice di byte può anche essere un file firmato PKCS7 (Authenticode); Il certificato del firmatario viene usato per creare l'oggetto .

Se si crea un X509Certificate2 certificato specificando un archivio file firmato PKCS7 per rawData, X509Certificate2 viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.