X509Certificate.Export Metoda

Reference

Definice

Obor názvů:: System.Security.Cryptography.X509Certificates

Sestavení:: System.Security.Cryptography.X509Certificates.dll

Sestavení:: System.Security.Cryptography.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Exportuje aktuální X509Certificate objekt do bajtového pole.

Přetížení

Export(X509ContentType)	Exportuje aktuální X509Certificate objekt do bajtového pole ve formátu popsaném jednou z X509ContentType hodnot.
Export(X509ContentType, SecureString)	Exportuje aktuální X509Certificate objekt do pole bajtů pomocí zadaného formátu a hesla.
Export(X509ContentType, String)	Exportuje aktuální X509Certificate objekt do bajtového pole ve formátu popsaném jednou z X509ContentType hodnot a pomocí zadaného hesla.

Export(X509ContentType)

Exportuje aktuální X509Certificate objekt do bajtového pole ve formátu popsaném jednou z X509ContentType hodnot.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]

Public Overridable Function Export (contentType As X509ContentType) As Byte()

Parametry

contentType: X509ContentType

Jedna z X509ContentType hodnot, které popisují formátování výstupních dat.

Návraty

Byte[]

Pole bajtů, které představuje aktuální X509Certificate objekt.

Atributy: ComVisibleAttribute

Výjimky

CryptographicException

Jiná hodnota než Cert, SerializedCertnebo Pkcs12 byla předána parametru contentType .

-nebo- Certifikát nelze exportovat.

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 pole bajtů 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

Parametr contentType přijímá pouze následující hodnoty výčtu X509ContentType : Cert, SerializedCerta Pkcs12. Předání jakékoli jiné hodnoty způsobí CryptographicException vyvolání.

Platí pro

Export(X509ContentType, SecureString)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Exportuje aktuální X509Certificate objekt do pole bajtů pomocí zadaného formátu a hesla.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString? password);

[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]

Public Overridable Function Export (contentType As X509ContentType, password As SecureString) As Byte()

Parametry

contentType: X509ContentType

Jedna z X509ContentType hodnot, které popisují formátování výstupních dat.

password: SecureString

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

Návraty

Byte[]

Bajtové pole, které představuje aktuální X509Certificate objekt.

Atributy: CLSCompliantAttribute

Výjimky

CryptographicException

Jiná hodnota než Cert, SerializedCertnebo Pkcs12 byla předána parametru contentType .

-nebo- Certifikát nelze exportovat.

Poznámky

Parametr contentType přijímá pouze následující hodnoty výčtu X509ContentType : Cert, SerializedCerta Pkcs12. Předání jakékoli jiné hodnoty způsobí CryptographicException vyvolání.

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.

Platí pro

Export(X509ContentType, String)

Exportuje aktuální X509Certificate objekt do bajtového pole ve formátu popsaném jednou z X509ContentType hodnot a pomocí zadaného hesla.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::String ^ password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string? password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]

Public Overridable Function Export (contentType As X509ContentType, password As String) As Byte()

Parametry

contentType: X509ContentType

Jedna z X509ContentType hodnot, které popisují formátování výstupních dat.

password: String

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

Návraty

Byte[]

Pole bajtů, které představuje aktuální X509Certificate objekt.

Atributy: ComVisibleAttribute

Výjimky

CryptographicException

Jiná hodnota než Cert, SerializedCertnebo Pkcs12 byla předána parametru contentType .

-nebo- Certifikát nelze exportovat.

Poznámky

Parametr contentType přijímá pouze následující hodnoty výčtu X509ContentType : Cert, SerializedCerta Pkcs12. Předání jakékoli jiné hodnoty způsobí CryptographicException vyvolání.

Důležité

Platí pro

X509Certificate.Export Metoda

Definice

Přetížení

Export(X509ContentType)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Export(X509ContentType, SecureString)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Export(X509ContentType, String)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Další materiály