X509Certificate2 Konstruktory

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.dll

Inicjuje nowe wystąpienie klasy X509Certificate2.

Przeciążenia

X509Certificate2()	Przestarzałe. Inicjuje nowe wystąpienie klasy X509Certificate2.
X509Certificate2(String, String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate2 klasy przy użyciu nazwy pliku certyfikatu, hasła używanego do uzyskiwania dostępu do certyfikatu i flagi magazynu kluczy.
X509Certificate2(String, SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu X509Certificate2 , hasła i flagi magazynu kluczy.
X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu X509Certificate2 , hasła i flagi magazynu kluczy.
X509Certificate2(Byte[], String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu tablicy bajtów X509Certificate2 , hasła i flagi magazynu kluczy.
X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy przy użyciu tablicy bajtów X509Certificate2 , hasła i flagi magazynu kluczy.
X509Certificate2(String, String)	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu i hasła używanego do uzyskiwania dostępu do certyfikatu.
X509Certificate2(String, SecureString)	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu i hasła.
X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)	Inicjuje nowe wystąpienie klasy z danych certyfikatu X509Certificate2 , hasła i flag magazynu kluczy.
X509Certificate2(Byte[], String)	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate2(Byte[], SecureString)	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate2(String)	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu.
X509Certificate2(X509Certificate)	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu X509Certificate obiektu.
X509Certificate2(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu określonych informacji o kontekście serializacji i strumienia.
X509Certificate2(ReadOnlySpan<Byte>)	Inicjuje X509Certificate2 nowe wystąpienie klasy z danych certyfikatu.
X509Certificate2(IntPtr)	Inicjuje nowe wystąpienie klasy przy użyciu niezarządzanego uchwytu X509Certificate2 .
X509Certificate2(Byte[])	Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu informacji z tablicy bajtów.

X509Certificate2()

Źródło:

X509Certificate2.cs

Przestroga

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

Inicjuje nowe wystąpienie klasy X509Certificate2.

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

Atrybuty

ObsoleteAttribute UnsupportedOSPlatformAttribute

Przykłady

Poniższy przykład kodu otwiera bieżący magazyn certyfikatów użytkownika, wybiera tylko aktywne certyfikaty, a następnie umożliwia użytkownikowi wybranie co najmniej jednego certyfikatu. W tym przykładzie są zapisywane informacje o certyfikacie w konsoli programu .

#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

Uwagi

Ten konstruktor tworzy pusty X509Certificate2 obiekt, w przeciwieństwie do innych konstruktorów dla tej klasy, które używają informacji o certyfikacie z tablicy bajtów, wskaźnika lub pliku certyfikatu.

X509Certificate2(String, String, X509KeyStorageFlags)

Źródło:

X509Certificate2.cs

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

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)

Parametry

fileName

String

Nazwa pliku certyfikatu.

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu nazwy pliku certyfikatu, hasła potrzebnego do uzyskania dostępu do certyfikatu i flagi magazynu kluczy.

Ważne

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

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

X509Certificate2(String, SecureString, X509KeyStorageFlags)

Źródło:

X509Certificate2.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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)

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

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 żadnego z certyfikatów w magazynie.

X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)

Źródło:

X509Certificate2.cs

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

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

Parametry

fileName

String

Nazwa pliku certyfikatu.

password

ReadOnlySpan<Char>

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ważne

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

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

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Źródło:

X509Certificate2.cs

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

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)

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu tablicy bajtów, hasła potrzebnego do uzyskania dostępu do danych certyfikatu i flagi magazynu kluczy. Jest on używany z plikami PKCS12 (PFX), które zawierają klucz prywatny certyfikatu. 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.

Ważne

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

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

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Źródło:

X509Certificate2.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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)

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor jest używany z plikami PKCS12 (PFX), które zawierają klucz prywatny certyfikatu. 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.

Ważne

Nigdy nie koduje hasła w kodzie źródłowym. Zakodowane na kodzie hasła można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), edytora szesnastkowy 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 żadnego z certyfikatów w magazynie.

X509Certificate2(String, String)

Źródło:

X509Certificate2.cs

Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu i hasła używanego do uzyskiwania dostępu do certyfikatu.

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)

Parametry

fileName

String

Nazwa pliku certyfikatu.

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu nazwy pliku certyfikatu i hasła potrzebnego do uzyskania dostępu do certyfikatu. Jest on używany z plikami PKCS12 (PFX), które zawierają klucz prywatny certyfikatu. 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. Zakodowane na kodzie hasła można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), edytora szesnastkowy lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

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

X509Certificate2(String, SecureString)

Źródło:

X509Certificate2.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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)

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. Na przykład:

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor jest używany z plikami PKCS12 (PFX), które zawierają klucz prywatny certyfikatu. 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. Zakodowane na kodzie hasła można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), edytora szesnastkowy 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 żadnego z certyfikatów w magazynie.

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

Źródło:

X509Certificate2.cs

Inicjuje nowe wystąpienie klasy z danych certyfikatu X509Certificate2 , hasła i flag magazynu kluczy.

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

Parametry

rawData

ReadOnlySpan<Byte>

Dane certyfikatu do przetworzenia.

password

ReadOnlySpan<Char>

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

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.

X509Certificate2(Byte[], String)

Źródło:

X509Certificate2.cs

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

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)

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

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu tablicy bajtów i hasła potrzebnego do uzyskania dostępu do danych certyfikatu. Jest on używany z plikami PKCS12 (PFX), które zawierają klucz prywatny certyfikatu. 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. Zakodowane na kodzie hasła można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), edytora szesnastkowy lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.

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

X509Certificate2(Byte[], SecureString)

Źródło:

X509Certificate2.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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)

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

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor jest używany z plikami PKCS12 (PFX), które zawierają klucz prywatny certyfikatu. 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. Zakodowane na kodzie hasła można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler), edytora szesnastkowy 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 żadnego z certyfikatów w magazynie.

X509Certificate2(String)

Źródło:

X509Certificate2.cs

Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu nazwy pliku certyfikatu.

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)

Parametry

fileName

String

Nazwa pliku certyfikatu.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

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

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu nazwy pliku certyfikatu. Obsługuje kodowanie binarne (DER) lub kodowanie Base64.

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

X509Certificate2(X509Certificate)

Źródło:

X509Certificate2.cs

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

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)

Parametry

certificate

X509Certificate

Obiekt X509Certificate.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

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

• Plik certyfikatu nie istnieje.

• Certyfikat jest nieprawidłowy.

• Hasło certyfikatu jest niepoprawne.

Uwagi

Ta metoda tworzy nowe wystąpienie X509Certificate2 klasy przy użyciu X509Certificate obiektu.

X509Certificate2(SerializationInfo, StreamingContext)

Źródło:

X509Certificate2.cs

Przestroga

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

Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu określonych informacji o kontekście serializacji i strumienia.

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)

Parametry

info

SerializationInfo

Informacje o serializacji wymagane do deserializacji nowego X509Certificate2elementu .

context

StreamingContext

Kontekstowe informacje o źródle strumienia do deserializacji.

Atrybuty

ObsoleteAttribute

Wyjątki

PlatformNotSupportedException

Tylko platformy .NET Core i .NET 5+: we wszystkich przypadkach.

X509Certificate2(ReadOnlySpan<Byte>)

Źródło:

X509Certificate2.cs

Inicjuje X509Certificate2 nowe wystąpienie klasy na podstawie danych certyfikatu.

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

Parametry

rawData

ReadOnlySpan<Byte>

Dane certyfikatu do przetworzenia.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Występuje błąd certyfikatu.

X509Certificate2(IntPtr)

Źródło:

X509Certificate2.cs

Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu niezarządzanego dojścia.

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)

Parametry

handle

IntPtr

nativeint

Wskaźnik do kontekstu certyfikatu w kodzie niezarządzanym. Struktura języka C nosi nazwę 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.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu uchwytu dla kontekstu certyfikatu interfejsu API kryptograficznego firmy Microsoft. PCCERT_CONTEXT Należy pamiętać, że bezpośredni obiekt wywołujący tego konstruktora wymaga niezarządzanego uprawnienia do kodu.

Ważne

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 X509Certificate2 obiektu.

X509Certificate2(Byte[])

Źródło:

X509Certificate2.cs

Inicjuje X509Certificate2 nowe wystąpienie klasy przy użyciu informacji z tablicy bajtów.

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

Parametry

rawData

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.

Uwagi

Ten konstruktor tworzy nowy X509Certificate2 obiekt przy użyciu informacji o certyfikacie z tablicy bajtów. Tablica bajtów może być zakodowana binarnie (DER) lub zakodowana w formacie Base64 dane X.509. Tablica bajtów może być również plikiem podpisanym PKCS7 (Authenticode); certyfikat użytkownika podpisającego służy do tworzenia obiektu.

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