Condividi tramite


X509Certificate Costruttori

Definizione

Inizializza una nuova istanza della classe X509Certificate.

Overload

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(IntPtr)

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

X509Certificate(X509Certificate)

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

X509Certificate(String)
Obsoleti.

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

X509Certificate(Byte[], SecureString)
Obsoleti.

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

X509Certificate(Byte[], String)
Obsoleti.

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

X509Certificate(SerializationInfo, StreamingContext)
Obsoleti.

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

X509Certificate(String, SecureString)
Obsoleti.

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

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(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, X509KeyStorageFlags)
Obsoleti.

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

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

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

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

Attenzione

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Inizializza una nuova istanza della classe X509Certificate.

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

Commenti

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

Si applica a

X509Certificate(Byte[])

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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

public:
 X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate (byte[] data);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] data);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file di certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro rawData è null.

-oppure-

La lunghezza del parametro rawData è 0.

Esempio

Nell'esempio seguente viene caricato un file di certificato X.509 in un X509Certificate oggetto, esporta il certificato come matrice di byte e quindi importa la matrice di byte in un altro X509Certificate oggetto.

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.

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

Si applica a

X509Certificate(IntPtr)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

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

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

Parametri

handle
IntPtr

nativeint

Handle per una struttura PCCERT_CONTEXT non gestita.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file di certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il parametro dell'handle non rappresenta una struttura PCCERT_CONTEXT valida.

Commenti

Questo costruttore crea un nuovo X509Certificate oggetto usando un handle per il contesto del certificato API crittografico Microsoft, PCCERT_CONTEXT.

Importante

Questo costruttore crea una copia del contesto del certificato. Non presupporre che la struttura del 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 X509Certificate .

Si applica a

X509Certificate(X509Certificate)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

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

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (cert As X509Certificate)

Parametri

cert
X509Certificate

Classe X509Certificate dalla quale inizializzare questa classe.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file di certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro cert è null.

Commenti

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

Si applica a

X509Certificate(String)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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

public:
 X509Certificate(System::String ^ fileName);
public X509Certificate (string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file di certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro fileName è null.

Esempio

L'esempio seguente carica un certificato X.509 da un file, chiama il ToString metodo e visualizza i risultati nella 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.

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.

Si applica a

X509Certificate(Byte[], SecureString)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Importante

Questa API non è conforme a CLS.

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

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);
public X509Certificate (byte[] rawData, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString)

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

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file di certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro rawData è null.

-oppure-

La lunghezza del parametro rawData è 0.

Commenti

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

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 X509Certificate certificato specificando un archivio file firmato PKCS7 per rawData, X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

Si applica a

X509Certificate(Byte[], String)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate (byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, string? password);
public X509Certificate (byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

password
String

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

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro rawData è null.

-oppure-

La lunghezza del parametro rawData è 0.

Commenti

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

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 X509Certificate certificato specificando un archivio file firmato PKCS7 per rawData, X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

Si applica a

X509Certificate(SerializationInfo, StreamingContext)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.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 X509Certificate usando un oggetto SerializationInfo e una struttura StreamingContext.

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

Parametri

info
SerializationInfo

Oggetto SerializationInfo che descrive le informazioni di serializzazione.

context
StreamingContext

Struttura StreamingContext che descrive le modalità di esecuzione della serializzazione.

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Si applica a

X509Certificate(String, SecureString)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

Importante

Questa API non è conforme a CLS.

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

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);
public X509Certificate (string fileName, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString)

Parametri

fileName
String

Nome di un file di certificato.

password
SecureString

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

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro fileName è null.

Commenti

ASN.1 DER è l'unico formato di certificato supportato da questa classe. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un contenitore di 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 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.

Si applica a

X509Certificate(String, String)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate (string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, string? password);
public X509Certificate (string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

password
String

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

Attributi

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro fileName è null.

Commenti

ASN.1 DER è l'unico formato di certificato supportato da questa classe. La chiamata a questo costruttore con la password corretta decrittografa la chiave privata e la salva in un contenitore di chiavi.

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.

Si applica a

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)

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

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro rawData è null.

-oppure-

La lunghezza del parametro rawData è 0.

Commenti

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.

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

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 X509Certificate certificato specificando un archivio file firmato PKCS7 per rawData, X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

Si applica a

X509Certificate(Byte[], String, X509KeyStorageFlags)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

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

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro rawData è null.

-oppure-

La lunghezza del parametro rawData è 0.

Commenti

Questo costruttore crea un nuovo X509Certificate oggetto usando una matrice di byte, una password necessaria per accedere ai dati del certificato e un flag di archiviazione delle chiavi. 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.

Il X509KeyStorageFlags valore può essere usato per controllare dove e come viene importata la chiave privata.

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

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 X509Certificate certificato specificando un archivio file firmato PKCS7 per rawData, X509Certificate viene creato per il certificato che ha firmato l'archivio anziché per uno qualsiasi dei certificati all'interno dell'archivio.

Si applica a

X509Certificate(String, SecureString, X509KeyStorageFlags)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

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

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file del certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro fileName è null.

Commenti

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.

Si applica a

X509Certificate(String, String, X509KeyStorageFlags)

Origine:
X509Certificate.cs
Origine:
X509Certificate.cs
Origine:
X509Certificate.cs

Attenzione

Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.

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.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Obsolete("Loading certificate data through the constructor or Import is obsolete. Use X509CertificateLoader instead to load certificates.", DiagnosticId="SYSLIB0057", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

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

Eccezioni

Si è verificato un errore relativo al certificato. Esempio:

  • Il file di certificato non esiste.

  • Il certificato non è valido.

  • La password del certificato non è corretta.

Il valore del parametro fileName è null.

Commenti

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.

Si applica a