X509Certificate Constructors

Definitie

Initialiseert een nieuw exemplaar van de X509Certificate klasse.

Overloads

Name Description
X509Certificate()
Verouderd.
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een certificaatbestandsnaam, een wachtwoord en een vlag voor sleutelopslag.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix, een wachtwoord en een vlag voor sleutelopslag.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix, een wachtwoord en een vlag voor sleutelopslag.

X509Certificate(String, String)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand en een wachtwoord voor toegang tot het certificaat.

X509Certificate(String, SecureString)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een certificaatbestandsnaam en een wachtwoord.

X509Certificate(SerializationInfo, StreamingContext)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een SerializationInfo object en een StreamingContext structuur.

X509Certificate(String, String, X509KeyStorageFlags)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand, een wachtwoord voor toegang tot het certificaat en een vlag voor sleutelopslag.

X509Certificate(Byte[], SecureString)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix en een wachtwoord.

X509Certificate(String)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand.

X509Certificate(X509Certificate)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een andere X509Certificate klasse.

X509Certificate(IntPtr)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een ingang naar een niet-beheerde PCCERT_CONTEXT structuur.

X509Certificate(Byte[])

Initialiseert een nieuw exemplaar van de X509Certificate klasse die is gedefinieerd op basis van een reeks bytes die een X.509v3-certificaat vertegenwoordigt.

X509Certificate(Byte[], String)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix en een wachtwoord.

X509Certificate()

Let op

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Let op

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

Initialiseert een nieuw exemplaar van de X509Certificate klasse.

public:
 X509Certificate();
public X509Certificate();
Public Sub New ()
Kenmerken

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Van toepassing op

X509Certificate(String, SecureString, X509KeyStorageFlags)

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een certificaatbestandsnaam, een wachtwoord en een vlag voor sleutelopslag.

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

Parameters

fileName
String

De naam van een certificaatbestand.

password
SecureString

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

keyStorageFlags
X509KeyStorageFlags

Een bitsgewijze combinatie van de opsommingswaarden die bepalen waar en hoe het certificaat moet worden geïmporteerd.

Kenmerken

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De fileName parameter is null.

Opmerkingen

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief fileNameop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(Byte[], String, X509KeyStorageFlags)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix, een wachtwoord en een vlag voor sleutelopslag.

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

Parameters

rawData
Byte[]

Een bytematrix met gegevens uit een X.509-certificaat.

password
String

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

keyStorageFlags
X509KeyStorageFlags

Een bitsgewijze combinatie van de opsommingswaarden die bepalen waar en hoe het certificaat moet worden geïmporteerd.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De rawData parameter is null.

– of –

De lengte van de rawData parameter is 0.

Opmerkingen

Met deze constructor maakt u een nieuw X509Certificate object met behulp van een bytematrix, een wachtwoord dat nodig is voor toegang tot de certificaatgegevens en een vlag voor sleutelopslag. Als u deze constructor aanroept met het juiste wachtwoord, wordt de persoonlijke sleutel ontsleuteld en opgeslagen in een Microsoft Cryptografische API Cryptographic Service Provider (CSP).

De X509KeyStorageFlags waarde kan worden gebruikt om te bepalen waar en hoe de persoonlijke sleutel wordt geïmporteerd.

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Important

Codeer nooit een wachtwoord in uw broncode. In code vastgelegde wachtwoorden kunnen worden opgehaald uit een assembly met behulp van de Ildasm.exe (IL Disassembler), een hexeditor of door de assembly te openen in een teksteditor zoals Notepad.exe.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief rawDataop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix, een wachtwoord en een vlag voor sleutelopslag.

public:
 X509Certificate(cli::array <System::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)]
public X509Certificate(byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
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)

Parameters

rawData
Byte[]

Een bytematrix die gegevens uit een X.509-certificaat bevat.

password
SecureString

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

keyStorageFlags
X509KeyStorageFlags

Een bitsgewijze combinatie van de opsommingswaarden die bepalen waar en hoe het certificaat moet worden geïmporteerd.

Kenmerken

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De rawData parameter is null.

– of –

De lengte van de rawData parameter is 0.

Opmerkingen

Als u deze constructor aanroept met het juiste wachtwoord, wordt de persoonlijke sleutel ontsleuteld en opgeslagen in een Microsoft Cryptografische API Cryptographic Service Provider (CSP).

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Important

Codeer nooit een wachtwoord in uw broncode. In code vastgelegde wachtwoorden kunnen worden opgehaald uit een assembly met behulp van de Ildasm.exe (IL Disassembler), een hexeditor of door de assembly te openen in een teksteditor zoals Notepad.exe.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief rawDataop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(String, String)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand en een wachtwoord voor toegang tot het certificaat.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate(string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String)

Parameters

fileName
String

De naam van een PKCS7-ondertekend bestand.

password
String

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De fileName parameter is null.

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund. Als u deze constructor aanroept met het juiste wachtwoord, wordt de persoonlijke sleutel ontsleuteld en opgeslagen in een sleutelcontainer.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief fileNameop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(String, SecureString)

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een certificaatbestandsnaam en een wachtwoord.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
public X509Certificate(string fileName, System.Security.SecureString password);
[System.CLSCompliant(false)]
public X509Certificate(string fileName, System.Security.SecureString password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString)

Parameters

fileName
String

De naam van een certificaatbestand.

password
SecureString

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

Kenmerken

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De fileName parameter is null.

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund. Als u deze constructor aanroept met het juiste wachtwoord, wordt de persoonlijke sleutel ontsleuteld en opgeslagen in een sleutelcontainer.

Important

Codeer nooit een wachtwoord in uw broncode. In code vastgelegde wachtwoorden kunnen worden opgehaald uit een assembly met behulp van de Ildasm.exe (IL Disassembler), een hexeditor of door de assembly te openen in een teksteditor zoals Notepad.exe.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief fileNameop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(SerializationInfo, StreamingContext)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een SerializationInfo object en een StreamingContext structuur.

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)

Parameters

info
SerializationInfo

Een SerializationInfo object dat serialisatie-informatie beschrijft.

context
StreamingContext

Een StreamingContext structuur die beschrijft hoe serialisatie moet worden uitgevoerd.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

Van toepassing op

X509Certificate(String, String, X509KeyStorageFlags)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand, een wachtwoord voor toegang tot het certificaat en een vlag voor sleutelopslag.

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

Parameters

fileName
String

De naam van een PKCS7-ondertekend bestand.

password
String

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

keyStorageFlags
X509KeyStorageFlags

Een bitsgewijze combinatie van de opsommingswaarden die bepalen waar en hoe het certificaat moet worden geïmporteerd.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De fileName parameter is null.

Opmerkingen

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief fileNameop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(Byte[], SecureString)

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix en een wachtwoord.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
public X509Certificate(byte[] rawData, System.Security.SecureString password);
[System.CLSCompliant(false)]
public X509Certificate(byte[] rawData, System.Security.SecureString password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString)

Parameters

rawData
Byte[]

Een bytematrix die gegevens uit een X.509-certificaat bevat.

password
SecureString

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

Kenmerken

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De rawData parameter is null.

– of –

De lengte van de rawData parameter is 0.

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Important

Codeer nooit een wachtwoord in uw broncode. In code vastgelegde wachtwoorden kunnen worden opgehaald uit een assembly met behulp van de Ildasm.exe (IL Disassembler), een hexeditor of door de assembly te openen in een teksteditor zoals Notepad.exe.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief rawDataop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(String)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand.

public:
 X509Certificate(System::String ^ fileName);
public X509Certificate(string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String)

Parameters

fileName
String

De naam van een PKCS7-ondertekend bestand.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De fileName parameter is null.

Voorbeelden

In het volgende voorbeeld wordt een X.509-certificaat uit een bestand geladen, wordt de ToString methode aangeroepen en worden de resultaten weergegeven in de console.

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

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief fileNameop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(X509Certificate)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een andere X509Certificate klasse.

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate(System.Security.Cryptography.X509Certificates.X509Certificate cert);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (cert As X509Certificate)

Parameters

cert
X509Certificate

Een X509Certificate klasse waaruit deze klasse moet worden geïnitialiseerd.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De waarde van de cert parameter is null.

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Van toepassing op

X509Certificate(IntPtr)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een ingang naar een niet-beheerde PCCERT_CONTEXT structuur.

public:
 X509Certificate(IntPtr handle);
public X509Certificate(IntPtr handle);
[System.Security.SecurityCritical]
public X509Certificate(IntPtr handle);
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)

Parameters

handle
IntPtr

nativeint

Een ingang naar een onbeheerde PCCERT_CONTEXT structuur.

Kenmerken

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De handleparameter vertegenwoordigt geen geldige PCCERT_CONTEXT structuur.

Opmerkingen

Met deze constructor maakt u een nieuw X509Certificate-object met behulp van een ingang voor de Microsoft context van het cryptografische API-certificaat PCCERT_CONTEXT.

Important

Met deze constructor maakt u een kopie van de certificaatcontext. Neem niet aan dat de contextstructuur die u aan de constructor hebt doorgegeven, geldig is; het is mogelijk vrijgegeven. U kunt een kopie van de huidige PCCERT_CONTEXT structuur ophalen uit de Handle eigenschap, maar deze is alleen geldig tijdens de levensduur van het X509Certificate object.

Van toepassing op

X509Certificate(Byte[])

Initialiseert een nieuw exemplaar van de X509Certificate klasse die is gedefinieerd op basis van een reeks bytes die een X.509v3-certificaat vertegenwoordigt.

public:
 X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate(byte[] data);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (data As Byte())

Parameters

data
Byte[]

Een bytematrix met gegevens uit een X.509-certificaat.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De data parameter is null.

– of –

De lengte van de data parameter is 0.

Voorbeelden

In het volgende voorbeeld wordt een X.509-certificaatbestand in een X509Certificate object geladen, wordt het certificaat geëxporteerd als een bytematrix en wordt de bytematrix vervolgens in een ander X509Certificate object geïmporteerd.

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

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief dataop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op

X509Certificate(Byte[], String)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix en een wachtwoord.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate(byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String)

Parameters

rawData
Byte[]

Een bytematrix met gegevens uit een X.509-certificaat.

password
String

Het wachtwoord dat is vereist voor toegang tot de X.509-certificaatgegevens.

Uitzonderingen

Er treedt een fout op met het certificaat. Voorbeeld:

  • Het certificaatbestand bestaat niet.

  • Het certificaat is ongeldig.

  • Het wachtwoord van het certificaat is onjuist.

De rawData parameter is null.

– of –

De lengte van de rawData parameter is 0.

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Important

Codeer nooit een wachtwoord in uw broncode. In code vastgelegde wachtwoorden kunnen worden opgehaald uit een assembly met behulp van de Ildasm.exe (IL Disassembler), een hexeditor of door de assembly te openen in een teksteditor zoals Notepad.exe.

Als u een X509Certificate certificaat maakt door een door PKCS7 ondertekend bestandsarchief rawDataop te geven, wordt het X509Certificate gemaakt voor het certificaat dat het archief heeft ondertekend in plaats van voor een van de certificaten in het archief.

Van toepassing op