Freigeben über


X509Certificate.Export Methode

Definition

Exportiert das aktuelle X509Certificate-Objekt in ein Bytearray.

Überlädt

Export(X509ContentType)

Exportiert das aktuelle X509Certificate-Objekt in einem durch einen der X509ContentType-Werte beschriebenen Format in ein Bytearray.

Export(X509ContentType, SecureString)

Exportiert das aktuelle X509Certificate-Objekt mit dem angegebenen Format und einem Kennwort in ein Bytearray.

Export(X509ContentType, String)

Exportiert das aktuelle X509Certificate-Objekt in einem durch einen der X509ContentType-Werte beschriebenen Format mithilfe des angegebenen Kennworts in ein Bytearray.

Export(X509ContentType)

Exportiert das aktuelle X509Certificate-Objekt in einem durch einen der X509ContentType-Werte beschriebenen Format in ein Bytearray.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType);
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
Public Overridable Function Export (contentType As X509ContentType) As Byte()

Parameter

contentType
X509ContentType

Einer der X509ContentType-Werte, die beschreiben, wie die Ausgabedaten formatiert werden.

Gibt zurück

Byte[]

Ein Array von Bytes, das das aktuelle X509Certificate-Objekt darstellt.

Attribute

Ausnahmen

Es wurde ein anderer Wert als Cert, SerializedCert oder Pkcs12 an den contentType-Parameter übergeben.

- oder - Das Zertifikat konnte nicht exportiert werden.

Beispiele

Im folgenden Beispiel wird eine X.509-Zertifikatdatei in ein X509Certificate Objekt geladen, das Zertifikat als Bytearray exportiert und anschließend das Bytearray in ein anderes X509Certificate Objekt importiert.

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

Hinweise

Der contentType Parameter akzeptiert nur die folgenden Werte der X509ContentType Enumeration: Cert, SerializedCert, und Pkcs12. Das Übergeben eines anderen Werts bewirkt, dass ein CryptographicException Wurf ausgelöst wird.

Gilt für

Export(X509ContentType, SecureString)

Wichtig

Diese API ist nicht CLS-kompatibel.

Exportiert das aktuelle X509Certificate-Objekt mit dem angegebenen Format und einem Kennwort in ein Bytearray.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
Public Overridable Function Export (contentType As X509ContentType, password As SecureString) As Byte()

Parameter

contentType
X509ContentType

Einer der X509ContentType-Werte, die beschreiben, wie die Ausgabedaten formatiert werden.

password
SecureString

Das für den Zugriff auf die X.509-Zertifikatsdaten erforderliche Kennwort.

Gibt zurück

Byte[]

Ein Bytearray, das das aktuelle X509Certificate-Objekt darstellt.

Attribute

Ausnahmen

Es wurde ein anderer Wert als Cert, SerializedCert oder Pkcs12 an den contentType-Parameter übergeben.

- oder - Das Zertifikat konnte nicht exportiert werden.

Hinweise

Der contentType Parameter akzeptiert nur die folgenden Werte der X509ContentType Enumeration: Cert, SerializedCert, und Pkcs12. Das Übergeben eines anderen Werts bewirkt, dass ein CryptographicException Wurf ausgelöst wird.

Wichtig

Ein Kennwort wird niemals in Ihrem Quellcode hart codieren. Hartcodierte Kennwörter können mithilfe der Ildasm.exe (IL Disassembler), eines Hex-Editors oder einfach die Assembly in einem Text-Editor wie Notepad.exe geöffnet werden.

Gilt für

Export(X509ContentType, String)

Exportiert das aktuelle X509Certificate-Objekt in einem durch einen der X509ContentType-Werte beschriebenen Format mithilfe des angegebenen Kennworts in ein Bytearray.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::String ^ password);
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string? password);
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
Public Overridable Function Export (contentType As X509ContentType, password As String) As Byte()

Parameter

contentType
X509ContentType

Einer der X509ContentType-Werte, die beschreiben, wie die Ausgabedaten formatiert werden.

password
String

Das für den Zugriff auf die X.509-Zertifikatsdaten erforderliche Kennwort.

Gibt zurück

Byte[]

Ein Array von Bytes, das das aktuelle X509Certificate-Objekt darstellt.

Attribute

Ausnahmen

Es wurde ein anderer Wert als Cert, SerializedCert oder Pkcs12 an den contentType-Parameter übergeben.

- oder - Das Zertifikat konnte nicht exportiert werden.

Hinweise

Der contentType Parameter akzeptiert nur die folgenden Werte der X509ContentType Enumeration: Cert, SerializedCert, und Pkcs12. Das Übergeben eines anderen Werts bewirkt, dass ein CryptographicException Wurf ausgelöst wird.

Wichtig

Ein Kennwort wird niemals in Ihrem Quellcode hart codieren. Hartcodierte Kennwörter können mithilfe der Ildasm.exe (IL Disassembler), eines Hex-Editors oder einfach die Assembly in einem Text-Editor wie Notepad.exe geöffnet werden.

Gilt für