X509Certificate2 Konstruktoren

Definition

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Initialisiert eine neue Instanz der X509Certificate2-Klasse.

Überlädt

X509Certificate2()	Veraltet. Initialisiert eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(String, String, X509KeyStorageFlags)	Initialisiert mithilfe eines Zertifikatsdateinamens, eines für den Zugriff auf das Zertifikat verwendeten Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(String, SecureString, X509KeyStorageFlags)	Initialisiert mithilfe eines Zertifikatsdateinamens, eines Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)	Initialisiert mithilfe eines Zertifikatsdateinamens, eines Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(Byte[], String, X509KeyStorageFlags)	Initialisiert eine neue Instanz der X509Certificate2-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.
X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)	Initialisiert eine neue Instanz der X509Certificate2-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.
X509Certificate2(String, String)	Initialisiert mithilfe des Zertifikatsdateinamens und eines für den Zugriff auf das Zertifikat verwendeten Kennworts eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(String, SecureString)	Initialisiert mithilfe eines Zertifikatsdateinamens und eines Kennworts eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)	Initialisiert aus Zertifikatsdaten, einem Kennwort und Schlüsselspeicherflags eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(Byte[], String)	Initialisiert eine neue Instanz der X509Certificate2-Klasse mit einem Bytearray und einem Kennwort.
X509Certificate2(Byte[], SecureString)	Initialisiert eine neue Instanz der X509Certificate2-Klasse mit einem Bytearray und einem Kennwort.
X509Certificate2(String)	Initialisiert mithilfe eines Zertifikatsdateinamens eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(X509Certificate)	Initialisiert eine neue Instanz der X509Certificate2-Klasse mit einem X509Certificate-Objekt.
X509Certificate2(SerializationInfo, StreamingContext)	Veraltet. Initialisiert eine neue Instanz der X509Certificate2-Klasse mit den angegebenen Serialisierungs- und Streamkontextinformationen.
X509Certificate2(ReadOnlySpan<Byte>)	Initialisiert eine neue Instanz der X509Certificate2-Klasse aus Zertifikatdaten.
X509Certificate2(IntPtr)	Initialisiert mithilfe eines nicht verwalteten Handles eine neue Instanz der X509Certificate2-Klasse.
X509Certificate2(Byte[])	Initialisiert mithilfe der Informationen aus einem Bytearray eine neue Instanz der X509Certificate2-Klasse.

X509Certificate2()

Quelle:

X509Certificate2.cs

Achtung

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

Initialisiert eine neue Instanz der X509Certificate2-Klasse.

public:
 X509Certificate2();

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

Public Sub New ()

Attribute

ObsoleteAttribute UnsupportedOSPlatformAttribute

Beispiele

Im folgenden Codebeispiel wird der aktuelle Benutzerzertifikatspeicher geöffnet, es werden nur aktive Zertifikate ausgewählt, und der Benutzer kann dann mindestens ein Zertifikat auswählen. Im Beispiel werden dann Zertifikatinformationen in die Konsole geschrieben.

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

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

}

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

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

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

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

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

Class CertSelect

    Shared Sub Main()

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

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

        store.Close()
    End Sub
End Class

Hinweise

Dieser Konstruktor erstellt ein leeres X509Certificate2 Objekt im Gegensatz zu den anderen Konstruktoren für diese Klasse, die Zertifikatinformationen aus einem Bytearray, einem Zeiger oder einer Zertifikatdatei verwenden.

X509Certificate2(String, String, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Initialisiert mithilfe eines Zertifikatsdateinamens, eines für den Zugriff auf das Zertifikat verwendeten Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate2-Klasse.

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

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

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

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

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

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.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 Objekt unter Verwendung eines Zertifikatdateinamens, eines Kennworts, das für den Zugriff auf das Zertifikat erforderlich ist, und einem Schlüsselspeicherflag.

Wichtig

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

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

X509Certificate2(String, SecureString, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

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

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

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

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

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

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.

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.

X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

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

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

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

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

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

password

ReadOnlySpan<Char>

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.

Hinweise

Wichtig

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

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

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

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

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

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

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

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

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.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 Objekt mithilfe eines Bytearrays, eines Kennworts, das für den Zugriff auf die Zertifikatdaten erforderlich ist, und einem Schlüsselspeicherflag. Es wird mit PKCS12-Dateien (PFX) verwendet, die den privaten Schlüssel des Zertifikats enthalten. Beim Aufrufen dieses Konstruktors mit dem richtigen Kennwort wird der private Schlüssel entschlüsselt und in einem Kryptografiedienstanbieter (CSP) der Microsoft Cryptographic API 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) oder eines Sechskant-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

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

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

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

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

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

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

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

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.

Hinweise

Dieser Konstruktor wird mit PKCS12-Dateien (PFX) verwendet, die den privaten Schlüssel des Zertifikats enthalten. 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.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können mithilfe des Ildasm.exe (IL Disassembler) oder eines Hexadezimierungs-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe aus einer Assembly 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.

X509Certificate2(String, String)

Quelle:

X509Certificate2.cs

Initialisiert mithilfe des Zertifikatsdateinamens und eines für den Zugriff auf das Zertifikat verwendeten Kennworts eine neue Instanz der X509Certificate2-Klasse.

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

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

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

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

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

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.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 Objekt mit einem Zertifikatdateinamen und einem Kennwort, das für den Zugriff auf das Zertifikat erforderlich ist. Sie wird mit PKCS12-Dateien (PFX) verwendet, die den privaten Schlüssel des Zertifikats enthalten. 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 mithilfe des Ildasm.exe (IL Disassembler) oder eines Hexadezimierungs-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe aus einer Assembly abgerufen werden.

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

X509Certificate2(String, SecureString)

Quelle:

X509Certificate2.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

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

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

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

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

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

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.

Hinweise

Dieser Konstruktor wird mit PKCS12-Dateien (PFX) verwendet, die den privaten Schlüssel des Zertifikats enthalten. 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 mithilfe des Ildasm.exe (IL Disassembler) oder eines Hexadezimierungs-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe aus einer Assembly 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.

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

Quelle:

X509Certificate2.cs

Initialisiert aus Zertifikatsdaten, einem Kennwort und Schlüsselspeicherflags eine neue Instanz der X509Certificate2-Klasse.

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

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

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

Parameter

rawData

ReadOnlySpan<Byte>

Die zu verarbeitenden Zertifikatdaten.

password

ReadOnlySpan<Char>

Das für den Zugriff auf die Zertifikatdaten erforderliche Kennwort.

keyStorageFlags

X509KeyStorageFlags

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

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler.

X509Certificate2(Byte[], String)

Quelle:

X509Certificate2.cs

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

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

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

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

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

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.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 Objekt mithilfe eines Bytearrays und eines Kennworts, das für den Zugriff auf die Zertifikatdaten erforderlich ist. Sie wird mit PKCS12-Dateien (PFX) verwendet, die den privaten Schlüssel des Zertifikats enthalten. 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 mithilfe des Ildasm.exe (IL Disassembler) oder eines Hexadezimierungs-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe aus einer Assembly abgerufen werden.

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

X509Certificate2(Byte[], SecureString)

Quelle:

X509Certificate2.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

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

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

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

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

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

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.

Hinweise

Dieser Konstruktor wird mit PKCS12-Dateien (PFX) verwendet, die den privaten Schlüssel des Zertifikats enthalten. 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 mithilfe des Ildasm.exe (IL Disassembler) oder eines Hexadezimierungs-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe aus einer Assembly 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.

X509Certificate2(String)

Quelle:

X509Certificate2.cs

Initialisiert mithilfe eines Zertifikatsdateinamens eine neue Instanz der X509Certificate2-Klasse.

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

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

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

Public Sub New (fileName As String)

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 -Objekt unter Verwendung eines Zertifikatdateinamens. Es unterstützt binäre (DER)-Codierung oder Base64-Codierung.

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

X509Certificate2(X509Certificate)

Quelle:

X509Certificate2.cs

Initialisiert eine neue Instanz der X509Certificate2-Klasse mit einem X509Certificate-Objekt.

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

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

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

Public Sub New (certificate As X509Certificate)

Parameter

certificate

X509Certificate

Ein X509Certificate-Objekt.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

Hinweise

Diese Methode erstellt mithilfe eines -Objekts eine X509Certificate neue instance der X509Certificate2 -Klasse.

X509Certificate2(SerializationInfo, StreamingContext)

Quelle:

X509Certificate2.cs

Achtung

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

Initialisiert eine neue Instanz der X509Certificate2-Klasse mit den angegebenen Serialisierungs- und Streamkontextinformationen.

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

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

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

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

Parameter

info

SerializationInfo

Die Serialisierungsinformationen, die zum Deserialisieren des neuen X509Certificate2 erforderlich sind.

context

StreamingContext

Kontextinformationen zur Quelle des Streams, der deserialisiert werden soll.

Attribute

ObsoleteAttribute

Ausnahmen

PlatformNotSupportedException

Nur .NET Core und .NET 5 und höher: In allen Fällen.

X509Certificate2(ReadOnlySpan<Byte>)

Quelle:

X509Certificate2.cs

Initialisiert eine neue Instanz der X509Certificate2-Klasse aus Zertifikatdaten.

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

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

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

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

Parameter

rawData

ReadOnlySpan<Byte>

Die zu verarbeitenden Zertifikatdaten.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler.

X509Certificate2(IntPtr)

Quelle:

X509Certificate2.cs

Initialisiert mithilfe eines nicht verwalteten Handles eine neue Instanz der X509Certificate2-Klasse.

public:
 X509Certificate2(IntPtr handle);

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

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

Public Sub New (handle As IntPtr)

Parameter

handle

IntPtr

nativeint

Ein Zeiger auf einen Zertifikatskontext in nicht verwaltetem Code. Die C-Struktur wird als PCCERT_CONTEXT bezeichnet.

Attribute

UnsupportedOSPlatformAttribute

Ausnahmen

CryptographicException

Zertifikatfehler. Zum Beispiel:

• Die Zertifikatdatei ist nicht vorhanden.

• Das Zertifikat ist ungültig.

• Das Kennwort des Zertifikats ist falsch.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 Objekt unter Verwendung eines Handles für den Zertifikatkontext der Microsoft Cryptographic API. PCCERT_CONTEXT Beachten Sie, dass der unmittelbare Aufrufer dieses Konstruktors nicht verwaltete Codeberechtigungen erfordert.

Wichtig

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

X509Certificate2(Byte[])

Quelle:

X509Certificate2.cs

Initialisiert mithilfe der Informationen aus einem Bytearray eine neue Instanz der X509Certificate2-Klasse.

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

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

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

Public Sub New (rawData As Byte())

Parameter

rawData

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.

Hinweise

Dieser Konstruktor erstellt ein neues X509Certificate2 Objekt mithilfe von Zertifikatinformationen aus einem Bytearray. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen. Das Bytearray kann auch eine mit PKCS7 (Authenticode) signierte Datei sein. das Signaturzertifikat wird verwendet, um das Objekt zu erstellen.

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