X509Certificate Konstruktory

Definice

Inicializuje novou instanci X509Certificate třídy.

Přetížení

X509Certificate()
Zastaralé.

Inicializuje novou instanci X509Certificate třídy.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Inicializuje novou instanci X509Certificate třídy pomocí názvu souboru certifikátu, hesla a příznaku úložiště klíčů.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Inicializuje novou instanci X509Certificate třídy pomocí bajtového pole, hesla a příznaku úložiště klíčů.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Inicializuje novou instanci X509Certificate třídy pomocí bajtového pole, hesla a příznaku úložiště klíčů.

X509Certificate(String, String)

Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7 a hesla pro přístup k certifikátu.

X509Certificate(String, SecureString)

Inicializuje novou instanci X509Certificate třídy pomocí názvu souboru certifikátu a hesla.

X509Certificate(SerializationInfo, StreamingContext)

Inicializuje novou instanci X509Certificate třídy pomocí SerializationInfo objektu a StreamingContext struktury.

X509Certificate(String, String, X509KeyStorageFlags)

Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7, hesla pro přístup k certifikátu a příznaku úložiště klíčů.

X509Certificate(Byte[], SecureString)

Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů a hesla.

X509Certificate(String)

Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7.

X509Certificate(X509Certificate)

Inicializuje novou instanci X509Certificate třídy pomocí jiné X509Certificate třídy.

X509Certificate(IntPtr)

Inicializuje novou instanci X509Certificate třídy pomocí úchytu pro nespravovanou PCCERT_CONTEXT strukturu.

X509Certificate(Byte[])

Inicializuje novou instanci X509Certificate třídy definované ze sekvence bajtů představující certifikát X.509v3.

X509Certificate(Byte[], String)

Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů a hesla.

X509Certificate()

Upozornění

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

Inicializuje novou instanci X509Certificate třídy.

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

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Platí pro

X509Certificate(String, SecureString, X509KeyStorageFlags)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci X509Certificate třídy pomocí názvu souboru certifikátu, hesla a příznaku úložiště klíčů.

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

Název souboru certifikátu.

password
SecureString

Heslo potřebné pro přístup k datům certifikátu X.509.

keyStorageFlags
X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat certifikát.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

  • Heslo certifikátu je nesprávné.

Parametr fileName je null.

Poznámky

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro fileName, vytvoří se pro certifikát podepsaný úložištěm, X509Certificate nikoli pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(Byte[], String, X509KeyStorageFlags)

Inicializuje novou instanci X509Certificate třídy pomocí bajtového pole, hesla a příznaku úložiště klíčů.

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

Bajtové pole obsahující data z certifikátu X.509

password
String

Heslo potřebné pro přístup k datům certifikátu X.509.

keyStorageFlags
X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat certifikát.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

  • Heslo certifikátu je nesprávné.

Parametr rawData je null.

-nebo- Délka parametru rawData je 0.

Poznámky

Tento konstruktor vytvoří nový X509Certificate objekt pomocí bajtového pole, hesla, které je potřeba pro přístup k datům certifikátu a příznak úložiště klíčů. Volání tohoto konstruktoru se správným heslem dešifruje privátní klíč a uloží ho do poskytovatele kryptografických služeb (CSP) rozhraní Microsoft Cryptographic API.

Hodnotu X509KeyStorageFlags lze použít k řízení, kde a jak se privátní klíč importuje.

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Důležité

Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla lze načíst ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, jako je Notepad.exe.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro rawData, vytvoří se pro certifikát podepsaný úložištěm, X509Certificate nikoli pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci X509Certificate třídy pomocí bajtového pole, hesla a příznaku úložiště klíčů.

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

Bajtové pole, které obsahuje data z certifikátu X.509.

password
SecureString

Heslo potřebné pro přístup k datům certifikátu X.509.

keyStorageFlags
X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat certifikát.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

  • Heslo certifikátu je nesprávné.

Parametr rawData je null.

-nebo- Délka parametru rawData je 0.

Poznámky

Volání tohoto konstruktoru se správným heslem dešifruje privátní klíč a uloží ho do poskytovatele kryptografických služeb (CSP) rozhraní Microsoft Cryptographic API.

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Důležité

Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla lze načíst ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, jako je Notepad.exe.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro rawData, vytvoří se pro certifikát podepsaný úložištěm, X509Certificate nikoli pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(String, String)

Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7 a hesla pro přístup k certifikátu.

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

Název podepsaného souboru PKCS7.

password
String

Heslo potřebné pro přístup k datům certifikátu X.509.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

  • Heslo certifikátu je nesprávné.

Parametr fileName je null.

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou. Volání tohoto konstruktoru se správným heslem dešifruje privátní klíč a uloží ho do kontejneru klíčů.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro fileName, vytvoří se pro certifikát podepsaný úložištěm, X509Certificate nikoli pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(String, SecureString)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci X509Certificate třídy pomocí názvu souboru certifikátu a hesla.

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

Název souboru certifikátu.

password
SecureString

Heslo potřebné pro přístup k datům certifikátu X.509

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

  • Heslo certifikátu je nesprávné.

Parametr fileName je null.

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou. Volání tohoto konstruktoru se správným heslem dešifruje privátní klíč a uloží ho do kontejneru klíčů.

Důležité

Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla lze načíst ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, jako je Notepad.exe.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro fileName, vytvoří se pro certifikát podepsaný úložištěm, X509Certificate nikoli pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(SerializationInfo, StreamingContext)

Inicializuje novou instanci X509Certificate třídy pomocí SerializationInfo objektu a 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

Objekt SerializationInfo , který popisuje informace o serializaci.

context
StreamingContext

Struktura StreamingContext , která popisuje, jak se má serializace provádět.

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Platí pro

X509Certificate(String, String, X509KeyStorageFlags)

Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7, hesla pro přístup k certifikátu a příznaku úložiště klíčů.

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

Název podepsaného souboru PKCS7.

password
String

Heslo potřebné pro přístup k datům certifikátu X.509.

keyStorageFlags
X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat certifikát.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

  • Heslo certifikátu je nesprávné.

Parametr fileName je null.

Poznámky

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro fileName, vytvoří se pro certifikát podepsaný úložištěm, X509Certificate nikoli pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(Byte[], SecureString)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů a hesla.

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

Pole bajtů obsahující data z certifikátu X.509

password
SecureString

Heslo potřebné pro přístup k datům certifikátu X.509

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Parametr rawData je null.

-nebo- Délka parametru rawData je 0.

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Důležité

Nikdy pevně kódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla lze načíst ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, jako je například Notepad.exe.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro rawData, X509Certificate vytvoří se pro certifikát, který podepsal úložiště, a ne pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(String)

Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru 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

Název podepsaného souboru PKCS7

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Parametr fileName je null.

Příklady

Následující příklad načte certifikát X.509 ze souboru, zavolá metodu ToString a zobrazí výsledky konzoly.

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

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro fileName, X509Certificate vytvoří se pro certifikát, který podepsal úložiště, a ne pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(X509Certificate)

Inicializuje novou instanci X509Certificate třídy pomocí jiné X509Certificate třídy.

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

Třída X509Certificate , ze které chcete inicializovat tuto třídu.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Hodnota parametru cert je null.

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Platí pro

X509Certificate(IntPtr)

Inicializuje novou instanci X509Certificate třídy pomocí úchytu pro nespravovanou PCCERT_CONTEXT strukturu.

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

Popisovač nespravované PCCERT_CONTEXT struktury.

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Parametr popisovače nepředstavuje platnou PCCERT_CONTEXT strukturu.

Poznámky

Tento konstruktor vytvoří nový X509Certificate objekt pomocí popisovače pro kontext certifikátu rozhraní Microsoft Cryptographic API. PCCERT_CONTEXT

Důležité

Tento konstruktor vytvoří kopii kontextu certifikátu. Nepředpokládáte, že kontextová struktura, kterou jste předali konstruktoru, je platná; možná byla vydána. Z vlastnosti můžete získat kopii aktuální PCCERT_CONTEXT struktury Handle , ale je platná pouze během doby života objektu X509Certificate .

Platí pro

X509Certificate(Byte[])

Inicializuje novou instanci X509Certificate třídy definované ze sekvence bajtů představující certifikát 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[]

Pole bajtů obsahující data z certifikátu X.509

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Parametr rawData je null.

-nebo- Délka parametru rawData je 0.

Příklady

Následující příklad načte soubor certifikátu X.509 do objektu X509Certificate , exportuje certifikát jako pole bajtů a potom importuje bajtové pole do jiného X509Certificate objektu.

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

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro data, X509Certificate vytvoří se pro certifikát, který podepsal úložiště, a ne pro žádné certifikáty v úložišti.

Platí pro

X509Certificate(Byte[], String)

Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů a hesla.

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

Pole bajtů obsahující data z certifikátu X.509

password
String

Heslo potřebné pro přístup k datům certifikátu X.509

Atributy

Výjimky

Dojde k chybě s certifikátem. Například:

– Soubor certifikátu neexistuje.

  • Certifikát je neplatný.

– Heslo certifikátu je nesprávné.

Parametr rawData je null.

-nebo- Délka parametru rawData je 0.

Poznámky

ASN.1 DER je jediný formát certifikátu podporovaný touto třídou.

Důležité

Nikdy pevně kódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla lze načíst ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, jako je například Notepad.exe.

Pokud vytvoříte X509Certificate certifikát zadáním podepsaného úložiště souborů PKCS7 pro rawData, X509Certificate vytvoří se pro certifikát, který podepsal úložiště, a ne pro žádné certifikáty v úložišti.

Platí pro