X509Certificate Konstruktory

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.dll

Inicjuje nowe wystąpienie klasy X509Certificate.

Przeciążenia

X509Certificate()	Przestarzałe. Inicjuje nowe wystąpienie klasy X509Certificate.
X509Certificate(Byte[])	Inicjuje nowe wystąpienie X509Certificate klasy zdefiniowanej na podstawie sekwencji bajtów reprezentujących certyfikat X.509v3.
X509Certificate(IntPtr)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu uchwytu do struktury niezarządzanej PCCERT_CONTEXT .
X509Certificate(X509Certificate)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu innej X509Certificate klasy.
X509Certificate(String)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu nazwy podpisanego pliku PKCS7.
X509Certificate(Byte[], SecureString)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate(Byte[], String)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu SerializationInfo obiektu i StreamingContext struktury.
X509Certificate(String, SecureString)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu i hasła.
X509Certificate(String, String)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy podpisanego pliku PKCS7 i hasła w celu uzyskania dostępu do certyfikatu.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu tablicy bajtów, hasła i flagi magazynu kluczy.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu tablicy bajtów, hasła i flagi magazynu kluczy.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu, hasła i flagi magazynu kluczy.
X509Certificate(String, String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy podpisanego pliku PKCS7, hasła dostępu do certyfikatu i flagi magazynu kluczy.

X509Certificate()

Źródło:

X509Certificate.cs

Przestroga

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

Inicjuje nowe wystąpienie klasy X509Certificate.

public:
 X509Certificate();

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

Public Sub New ()

Atrybuty

ObsoleteAttribute UnsupportedOSPlatformAttribute

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

X509Certificate(Byte[])

Źródło:

X509Certificate.cs

Inicjuje nowe wystąpienie X509Certificate klasy zdefiniowanej na podstawie sekwencji bajtów reprezentujących certyfikat X.509v3.

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

Parametry

data

Byte[]

Tablica bajtów zawierająca dane z certyfikatu X.509.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData ma wartość null.

-lub-

Długość parametru rawData wynosi 0.

Przykłady

Poniższy przykład ładuje plik certyfikatu X.509 do X509Certificate obiektu, eksportuje certyfikat jako tablicę bajtów, a następnie importuje tablicę bajtów do innego X509Certificate obiektu.

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

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla dataprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(IntPtr)

Źródło:

X509Certificate.cs

Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu uchwytu do struktury niezarządzanej PCCERT_CONTEXT .

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)

Parametry

handle

IntPtr

nativeint

Uchwyt do struktury niezarządzanej PCCERT_CONTEXT .

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr dojścia nie reprezentuje prawidłowej PCCERT_CONTEXT struktury.

Uwagi

Ten konstruktor tworzy nowy X509Certificate obiekt przy użyciu uchwytu dla kontekstu certyfikatu interfejsu API kryptograficznego firmy Microsoft. PCCERT_CONTEXT

Ważne

Ten konstruktor tworzy kopię kontekstu certyfikatu. Nie zakładaj, że struktura kontekstu przekazana do konstruktora jest prawidłowa; być może została wydana. Możesz pobrać kopię bieżącej PCCERT_CONTEXT struktury z Handle właściwości , ale jest ona prawidłowa tylko w okresie istnienia X509Certificate obiektu.

X509Certificate(X509Certificate)

Źródło:

X509Certificate.cs

Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu innej X509Certificate klasy.

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)

Parametry

cert

X509Certificate

Klasa X509Certificate , z której należy zainicjować tę klasę.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentNullException

Wartość parametru cert to null.

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

X509Certificate(String)

Źródło:

X509Certificate.cs

Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu nazwy podpisanego pliku PKCS7.

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)

Parametry

fileName

String

Nazwa podpisanego pliku PKCS7.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName ma wartość null.

Przykłady

Poniższy przykład ładuje certyfikat X.509 z pliku, wywołuje ToString metodę i wyświetla wyniki w konsoli.

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

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla fileNameprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(Byte[], SecureString)

Źródło:

X509Certificate.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.

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)

Parametry

rawData

Byte[]

Tablica bajtów zawierająca dane z certyfikatu X.509.

password

SecureString

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

Atrybuty

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData ma wartość null.

-lub-

Długość parametru rawData wynosi 0.

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

Ważne

Nigdy nie koduje trwale hasła w kodzie źródłowym. Zakodowane hasła można pobrać z zestawu przy użyciu Ildasm.exe (dezasembler IL), edytora szesnastkowego lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla rawDataprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(Byte[], String)

Źródło:

X509Certificate.cs

Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.

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)

Parametry

rawData

Byte[]

Tablica bajtów zawierająca dane z certyfikatu X.509.

password

String

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData ma wartość null.

-lub-

Długość parametru rawData wynosi 0.

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

Ważne

Nigdy nie koduje trwale hasła w kodzie źródłowym. Zakodowane hasła można pobrać z zestawu przy użyciu Ildasm.exe (dezasembler IL), edytora szesnastkowego lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla rawDataprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(SerializationInfo, StreamingContext)

Źródło:

X509Certificate.cs

Przestroga

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

Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu SerializationInfo obiektu i StreamingContext struktury.

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)

Parametry

info

SerializationInfo

SerializationInfo Obiekt opisujący informacje o serializacji.

context

StreamingContext

Struktura StreamingContext opisując sposób wykonywania serializacji.

Atrybuty

ObsoleteAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

X509Certificate(String, SecureString)

Źródło:

X509Certificate.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu i hasła.

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)

Parametry

fileName

String

Nazwa pliku certyfikatu.

password

SecureString

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

Atrybuty

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName ma wartość null.

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę. Wywołanie tego konstruktora z poprawnym hasłem odszyfrowuje klucz prywatny i zapisuje go w kontenerze kluczy.

Ważne

Nigdy nie koduje trwale hasła w kodzie źródłowym. Zakodowane hasła można pobrać z zestawu przy użyciu Ildasm.exe (dezasembler IL), edytora szesnastkowego lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla fileNameprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(String, String)

Źródło:

X509Certificate.cs

Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy podpisanego pliku PKCS7 i hasła w celu uzyskania dostępu do certyfikatu.

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)

Parametry

fileName

String

Nazwa podpisanego pliku PKCS7.

password

String

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName ma wartość null.

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę. Wywołanie tego konstruktora z poprawnym hasłem odszyfrowuje klucz prywatny i zapisuje go w kontenerze kluczy.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla fileNameprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Źródło:

X509Certificate.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu tablicy bajtów, hasła i flagi magazynu kluczy.

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)

Parametry

rawData

Byte[]

Tablica bajtów zawierająca dane z certyfikatu X.509.

password

SecureString

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia, które kontrolują miejsce i sposób importowania certyfikatu.

Atrybuty

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData ma wartość null.

-lub-

Długość parametru rawData wynosi 0.

Uwagi

Wywołanie tego konstruktora przy użyciu poprawnego hasła odszyfrowuje klucz prywatny i zapisuje go w dostawcy usług kryptograficznych (CSP) interfejsu API kryptograficznego firmy Microsoft.

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

Ważne

Nigdy nie koduje trwale hasła w kodzie źródłowym. Zakodowane hasła można pobrać z zestawu przy użyciu Ildasm.exe (dezasembler IL), edytora szesnastkowego lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla rawDataprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Źródło:

X509Certificate.cs

Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu tablicy bajtów, hasła i flagi magazynu kluczy.

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)

Parametry

rawData

Byte[]

Tablica bajtów zawierająca dane z certyfikatu X.509.

password

String

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia, które kontrolują miejsce i sposób importowania certyfikatu.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData ma wartość null.

-lub-

Długość parametru rawData wynosi 0.

Uwagi

Ten konstruktor tworzy nowy X509Certificate obiekt przy użyciu tablicy bajtów, hasła potrzebnego do uzyskania dostępu do danych certyfikatu i flagi magazynu kluczy. Wywołanie tego konstruktora przy użyciu poprawnego hasła odszyfrowuje klucz prywatny i zapisuje go w dostawcy usług kryptograficznych (CSP) interfejsu API kryptograficznego firmy Microsoft.

Wartość może służyć do kontrolowania X509KeyStorageFlags lokalizacji i sposobu importowania klucza prywatnego.

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

Ważne

Nigdy nie koduje trwale hasła w kodzie źródłowym. Zakodowane hasła można pobrać z zestawu przy użyciu Ildasm.exe (dezasembler IL), edytora szesnastkowego lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla rawDataprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Źródło:

X509Certificate.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu, hasła i flagi magazynu kluczy.

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)

Parametry

fileName

String

Nazwa pliku certyfikatu.

password

SecureString

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia, które kontrolują miejsce i sposób importowania certyfikatu.

Atrybuty

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName ma wartość null.

Uwagi

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla fileNameprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.

X509Certificate(String, String, X509KeyStorageFlags)

Źródło:

X509Certificate.cs

Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy podpisanego pliku PKCS7, hasła dostępu do certyfikatu i flagi magazynu kluczy.

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)

Parametry

fileName

String

Nazwa podpisanego pliku PKCS7.

password

String

Hasło wymagane do uzyskania dostępu do danych certyfikatu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia, które kontrolują miejsce i sposób importowania certyfikatu.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName ma wartość null.

Uwagi

Jeśli tworzysz X509Certificate certyfikat, określając podpisany magazyn plików PKCS7 dla fileNameprogramu , X509Certificate zostanie utworzony dla certyfikatu, który podpisał magazyn, a nie dla dowolnego certyfikatu w magazynie.