X509Certificate Konstruktory

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.X509Certificates.dll

Zestaw:

System.Security.Cryptography.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Inicjuje nowe wystąpienie klasy X509Certificate.

Przeciążenia

X509Certificate()	Nieaktualne. Inicjuje nowe wystąpienie klasy X509Certificate.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu X509Certificate , hasła i flagi magazynu kluczy.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu tablicy bajtów X509Certificate , hasła i flagi magazynu kluczy.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu tablicy bajtów X509Certificate , hasła i flagi magazynu kluczy.
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(String, SecureString)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu i hasła.
X509Certificate(SerializationInfo, StreamingContext)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu SerializationInfo obiektu i StreamingContext struktury.
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(Byte[], SecureString)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate(String)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu nazwy podpisanego pliku PKCS7.
X509Certificate(X509Certificate)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu innej X509Certificate klasy.
X509Certificate(IntPtr)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu uchwytu do struktury niezarządzanej PCCERT_CONTEXT .
X509Certificate(Byte[])	Inicjuje nowe wystąpienie X509Certificate klasy zdefiniowanej na podstawie sekwencji bajtów reprezentujących certyfikat X.509v3.
X509Certificate(Byte[], String)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.

X509Certificate()

Przestroga

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

Inicjuje nowe wystąpienie klasy X509Certificate.

public:
 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}")]
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(String, SecureString, X509KeyStorageFlags)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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

[System.CLSCompliant(false)]
public X509Certificate (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)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

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

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 z certyfikatem. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName to 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(Byte[], String, X509KeyStorageFlags)

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

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

public X509Certificate (byte[] rawData, 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);

public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

[<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 z certyfikatem. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData to 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 z poprawnym hasłem 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 hasła w kodzie źródłowym. Hasła zakodowane na podstawie kodu można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), 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[], SecureString, X509KeyStorageFlags)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie klasy przy użyciu tablicy bajtów X509Certificate , 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)]
public X509Certificate (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)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

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

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 z certyfikatem. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr rawData to null.

-lub- Długość parametru rawData wynosi 0.

Uwagi

Wywołanie tego konstruktora z poprawnym hasłem 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 hasła w kodzie źródłowym. Hasła zakodowane na podstawie kodu można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), 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, String)

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

public X509Certificate (string fileName, string? password);

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

public X509Certificate (string fileName, string password);

new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate

[<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 z certyfikatem. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName to 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(String, SecureString)

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)]
public X509Certificate (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)]
public X509Certificate (string fileName, System.Security.SecureString password);

public X509Certificate (string fileName, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

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

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 z certyfikatem. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName to 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 hasła w kodzie źródłowym. Hasła zakodowane na podstawie kodu można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), 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(SerializationInfo, StreamingContext)

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

public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

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.

Wyjątki

CryptographicException

Występuje błąd certyfikatu. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

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.

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

public X509Certificate (string fileName, 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);

public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

[<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 z certyfikatem. Przykład:

• Plik certyfikatu nie istnieje.

— Certyfikat jest nieprawidłowy.

— Hasło certyfikatu jest niepoprawne.

ArgumentException

Parametr fileName to 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(Byte[], SecureString)

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)]
public X509Certificate (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)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);

public X509Certificate (byte[] rawData, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

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

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

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

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

public X509Certificate (string fileName);

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

new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate

[<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. 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(X509Certificate)

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

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

public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);

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

new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate

[<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. 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(IntPtr)

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

public:
 X509Certificate(IntPtr handle);

public X509Certificate (IntPtr handle);

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

[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);

new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate

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

[<System.Security.SecurityCritical>]
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 SecurityCriticalAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu. 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(Byte[])

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

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

public X509Certificate (byte[] data);

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

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate

[<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. 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(Byte[], String)

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

public X509Certificate (byte[] rawData, string? password);

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

public X509Certificate (byte[] rawData, string password);

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate

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