X509Certificate Konstruktoren

Definition

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Initialisiert eine neue Instanz der X509Certificate-Klasse.

Überlädt

X509Certificate()	Veraltet. Initialisiert eine neue Instanz der X509Certificate-Klasse.
X509Certificate(Byte[])	Initialisiert eine neue Instanz der X509Certificate-Klasse, die aus einer Folge von Bytes zum Darstellen eines X.509v3-Zertifikats definiert ist.
X509Certificate(IntPtr)	Initialisiert mithilfe eines Handles für eine nicht verwaltete X509Certificate-Struktur eine neue Instanz der PCCERT_CONTEXT-Klasse.
X509Certificate(X509Certificate)	Initialisiert eine neue Instanz der X509Certificate-Klasse unter Verwendung einer anderen X509Certificate-Klasse.
X509Certificate(String)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei.
X509Certificate(Byte[], SecureString)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray und einem Kennwort.
X509Certificate(Byte[], String)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray und einem Kennwort.
X509Certificate(SerializationInfo, StreamingContext)	Veraltet. Initialisiert eine neue Instanz der X509Certificate-Klasse mithilfe eines SerializationInfo-Objekts und einer StreamingContext-Struktur.
X509Certificate(String, SecureString)	Initialisiert mithilfe eines Zertifikatsdateinamens und eines Kennworts eine neue Instanz der X509Certificate-Klasse.
X509Certificate(String, String)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei und einem Kennwort für den Zugriff auf das Zertifikat.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Initialisiert mithilfe eines Zertifikatsdateinamens, eines Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate-Klasse.
X509Certificate(String, String, X509KeyStorageFlags)	Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei, einem Kennwort für den Zugriff auf das Zertifikat und einem Schlüsselspeicherflag.

X509Certificate()

Quelle:

X509Certificate.cs

Achtung

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

Initialisiert eine neue Instanz der X509Certificate-Klasse.

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

Public Sub New ()

Attribute

ObsoleteAttribute UnsupportedOSPlatformAttribute

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

X509Certificate(Byte[])

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse, die aus einer Folge von Bytes zum Darstellen eines X.509v3-Zertifikats definiert ist.

public:
 X509Certificate(cli::array <System::Byte> ^ data);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);

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

Public Sub New (data As Byte())

Parameter

data

Byte[]

Ein Bytearray mit Daten aus einem X.509-Zertifikat.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der rawData-Parameter ist null.

- oder -

Die Länge des rawData-Parameters ist 0 (null).

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

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für dataangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(IntPtr)

Quelle:

X509Certificate.cs

Initialisiert mithilfe eines Handles für eine nicht verwaltete X509Certificate-Struktur eine neue Instanz der PCCERT_CONTEXT-Klasse.

public:
 X509Certificate(IntPtr handle);

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

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

Public Sub New (handle As IntPtr)

Parameter

handle

IntPtr

nativeint

Ein Handle für eine nicht verwaltete PCCERT_CONTEXT-Struktur.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der Parameter für das Handle stellt keine gültige PCCERT_CONTEXT-Struktur dar.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate -Objekt mithilfe eines Handles für den Microsoft Kryptografie-API-Zertifikatkontext, PCCERT_CONTEXT.

Wichtig

Dieser Konstruktor erstellt eine Kopie des Zertifikatkontexts. Gehen Sie nicht davon aus, dass die Kontextstruktur, die Sie an den Konstruktor übergeben haben, gültig ist. es wurde möglicherweise freigegeben. Sie können eine Kopie der aktuellen PCCERT_CONTEXT Struktur aus der Handle -Eigenschaft abrufen, aber sie ist nur während der Lebensdauer des X509Certificate Objekts gültig.

X509Certificate(X509Certificate)

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse unter Verwendung einer anderen X509Certificate-Klasse.

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);

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

[<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)

Parameter

cert

X509Certificate

Eine X509Certificate-Klasse, aus der diese Klasse initialisiert wird.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentNullException

Der Wert des cert-Parameters ist null.

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

X509Certificate(String)

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei.

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

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

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

Public Sub New (fileName As String)

Parameter

fileName

String

Der Name einer mit PKCS7 signierten Datei.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der fileName-Parameter ist null.

Beispiele

Im folgenden Beispiel wird ein X.509-Zertifikat aus einer Datei geladen, die ToString -Methode aufgerufen und die Ergebnisse in der Konsole angezeigt.

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

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für fileNameangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(Byte[], SecureString)

Quelle:

X509Certificate.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray und einem Kennwort.

public:
 X509Certificate(cli::array <System::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")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Parameter

rawData

Byte[]

Ein Bytearray, das Daten aus einem X.509-Zertifikat enthält.

password

SecureString

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

Attribute

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der rawData-Parameter ist null.

- oder -

Die Länge des rawData-Parameters ist 0 (null).

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler), eines Hexadembers oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für rawDataangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(Byte[], String)

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray und einem Kennwort.

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

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

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

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

Parameter

rawData

Byte[]

Ein Bytearray mit Daten aus einem X.509-Zertifikat.

password

String

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

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der rawData-Parameter ist null.

- oder -

Die Länge des rawData-Parameters ist 0 (null).

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler), eines Hexadembers oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für rawDataangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(SerializationInfo, StreamingContext)

Quelle:

X509Certificate.cs

Achtung

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

Initialisiert eine neue Instanz der X509Certificate-Klasse mithilfe eines SerializationInfo-Objekts und einer StreamingContext-Struktur.

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);

[<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)

Parameter

info

SerializationInfo

Ein SerializationInfo-Objekt, das Serialisierungsinformationen beschreibt.

context

StreamingContext

Eine StreamingContext-Struktur, die beschreibt, wie die Serialisierung ausgeführt werden soll.

Attribute

ObsoleteAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

X509Certificate(String, SecureString)

Quelle:

X509Certificate.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert mithilfe eines Zertifikatsdateinamens und eines Kennworts eine neue Instanz der X509Certificate-Klasse.

public:
 X509Certificate(System::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")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

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

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

password

SecureString

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

Attribute

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der fileName-Parameter ist null.

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird. Durch Aufrufen dieses Konstruktors mit dem richtigen Kennwort wird der private Schlüssel entschlüsselt und in einem Schlüsselcontainer gespeichert.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler), eines Hexadembers oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für fileNameangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(String, String)

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei und einem Kennwort für den Zugriff auf das Zertifikat.

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

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

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

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

Parameter

fileName

String

Der Name einer mit PKCS7 signierten Datei.

password

String

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

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der fileName-Parameter ist null.

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird. Durch Aufrufen dieses Konstruktors mit dem richtigen Kennwort wird der private Schlüssel entschlüsselt und in einem Schlüsselcontainer gespeichert.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für fileNameangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Quelle:

X509Certificate.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.

public:
 X509Certificate(cli::array <System::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")>]
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)

Parameter

rawData

Byte[]

Ein Bytearray, das Daten aus einem X.509-Zertifikat enthält.

password

SecureString

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

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der rawData-Parameter ist null.

- oder -

Die Länge des rawData-Parameters ist 0 (null).

Hinweise

Durch Aufrufen dieses Konstruktors mit dem richtigen Kennwort wird der private Schlüssel entschlüsselt und in einem Microsoft Cryptographic API Cryptographic Service Provider (CSP) gespeichert.

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler), eines Hexadembers oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für rawDataangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::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")>]
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)

Parameter

rawData

Byte[]

Ein Bytearray mit Daten aus einem X.509-Zertifikat.

password

String

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

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der rawData-Parameter ist null.

- oder -

Die Länge des rawData-Parameters ist 0 (null).

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate Objekt mithilfe eines Bytearrays, eines Kennworts, das für den Zugriff auf die Zertifikatdaten erforderlich ist, und einem Schlüsselspeicherflag. Durch Aufrufen dieses Konstruktors mit dem richtigen Kennwort wird der private Schlüssel entschlüsselt und in einem Microsoft Cryptographic API Cryptographic Service Provider (CSP) gespeichert.

Der X509KeyStorageFlags Wert kann verwendet werden, um zu steuern, wo und wie der private Schlüssel importiert wird.

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler), eines Hexadembers oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für rawDataangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate im Speicher.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Quelle:

X509Certificate.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert mithilfe eines Zertifikatsdateinamens, eines Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate-Klasse.

public:
 X509Certificate(System::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")>]
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)

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

password

SecureString

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

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der fileName-Parameter ist null.

Hinweise

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für fileNameangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate innerhalb des Speichers.

X509Certificate(String, String, X509KeyStorageFlags)

Quelle:

X509Certificate.cs

Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei, einem Kennwort für den Zugriff auf das Zertifikat und einem Schlüsselspeicherflag.

public:
 X509Certificate(System::String ^ fileName, System::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")>]
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)

Parameter

fileName

String

Der Name einer mit PKCS7 signierten Datei.

password

String

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

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

ArgumentException

Der fileName-Parameter ist null.

Hinweise

Wenn Sie ein X509Certificate Zertifikat erstellen, indem Sie einen PKCS7-Signierten Dateispeicher für fileNameangeben, wird für X509Certificate das Zertifikat erstellt, das den Speicher signiert hat, und nicht für eines der Zertifikate innerhalb des Speichers.