X509Certificate.Import Metodo

Definizione

Popola un oggetto X509Certificate.Populates an X509Certificate object.

Overload

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

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

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

Import(Byte[])

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

public:
 virtual void Import(cli::array <System::Byte> ^ rawData);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData);
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit
Public Overridable Sub Import (rawData As Byte())

Parametri

rawData
Byte[]

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

Attributi

Eccezioni

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

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

Commenti

Questo metodo può essere utilizzato per utilizzare la matrice di byte non elaborati di un certificato X. 509 e per popolare l'oggetto X509Certificate con i valori associati.This method can be used to take the raw byte array of an X.509 certificate and populate the X509Certificate object with its associated values.

Sicurezza

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

InheritanceDemand
per l'attendibilità totale per gli eredi.for full trust for inheritors. Questo membro non può essere ereditato da codice parzialmente attendibile.This member cannot be inherited by partially trusted code.

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

Import(String)

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

public:
 virtual void Import(System::String ^ fileName);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName);
abstract member Import : string -> unit
override this.Import : string -> unit
Public Overridable Sub Import (fileName As String)

Parametri

fileName
String

Nome di un file di certificato rappresentato come stringa.The name of a certificate file represented as a string.

Attributi

Eccezioni

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

Esempi

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

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"Certificate.cer";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate;
   cert->Import(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;


class X509
{

    static void Main()
    {

        // The path to the certificate.
        string Certificate = "Certificate.cer";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate();

        cert.Import(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

        cert.Import(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

Questo metodo utilizza un file di certificato, ad esempio un file con estensione cer, che rappresenta un certificato X. 509 e popola l'oggetto X509Certificate con il certificato contenuto nel file.This method uses a certificate file (such as a file with a .cer extension) that represents an X.509 certificate, and populates the X509Certificate object with the certificate that the file contains.

Sicurezza

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

InheritanceDemand
per l'attendibilità totale per gli eredi.for full trust for inheritors. Questo membro non può essere ereditato da codice parzialmente attendibile.This member cannot be inherited by partially trusted code.

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

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

Import(Byte[], SecureString, X509KeyStorageFlags)

Importante

Questa API non è conforme a CLS.

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.

public:
 virtual void Import(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parametri

rawData
Byte[]

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

password
SecureString

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

keyStorageFlags
X509KeyStorageFlags

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

Attributi

Eccezioni

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

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

Commenti

Importante

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

Sicurezza

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

InheritanceDemand
per l'attendibilità totale per gli eredi.for full trust for inheritors. Questo membro non può essere ereditato da codice parzialmente attendibile.This member cannot be inherited by partially trusted code.

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

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.

public:
 virtual void Import(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Parametri

rawData
Byte[]

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

password
String

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

keyStorageFlags
X509KeyStorageFlags

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

Attributi

Eccezioni

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

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

Commenti

Questo metodo può essere utilizzato per popolare un oggetto X509Certificate utilizzando una password per il certificato rappresentato dalla matrice di byte.This method can be used to populate an X509Certificate object using a password for the certificate represented by the byte array. Il valore X509KeyStorageFlags può essere utilizzato per controllare la posizione e la modalità di importazione della chiave privata.The X509KeyStorageFlags value can be used to control where and how the private key is imported.

Sicurezza

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

InheritanceDemand
per l'attendibilità totale per gli eredi.for full trust for inheritors. Questo membro non può essere ereditato da codice parzialmente attendibile.This member cannot be inherited by partially trusted code.

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

Import(String, SecureString, X509KeyStorageFlags)

Importante

Questa API non è conforme a CLS.

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.

public:
 virtual void Import(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parametri

fileName
String

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

password
SecureString

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

keyStorageFlags
X509KeyStorageFlags

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

Attributi

Eccezioni

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

Commenti

Importante

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

Sicurezza

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

InheritanceDemand
per l'attendibilità totale per gli eredi.for full trust for inheritors. Questo membro non può essere ereditato da codice parzialmente attendibile.This member cannot be inherited by partially trusted code.

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

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

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.

public:
 virtual void Import(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parametri

fileName
String

Nome di un file di certificato rappresentato come stringa.The name of a certificate file represented as a string.

password
String

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

keyStorageFlags
X509KeyStorageFlags

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

Attributi

Eccezioni

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

Commenti

Importante

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

Sicurezza

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

InheritanceDemand
per l'attendibilità totale per gli eredi.for full trust for inheritors. Questo membro non può essere ereditato da codice parzialmente attendibile.This member cannot be inherited by partially trusted code.

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

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

Si applica a