X509Certificate.Export Method (X509ContentType)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

Namespace:   System.Security.Cryptography.X509Certificates
Assembly:  mscorlib (in mscorlib.dll)

<ComVisibleAttribute(False)>
Public Overridable Function Export (
	contentType As X509ContentType
) As Byte()

Parameters

contentType
Type: System.Security.Cryptography.X509Certificates.X509ContentType

One of the X509ContentType values that describes how to format the output data.

Return Value

Type: System.Byte()

An array of bytes that represents the current X509Certificate object.

Exception Condition
CryptographicException

A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-or-

The certificate could not be exported.

The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Passing any other value causes a CryptographicException to be thrown.

The following example loads an X.509 certificate file into an X509Certificate object, exports the certificate as a byte array, and then imports the byte array into another X509Certificate object.

Imports System
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

KeyContainerPermission

for permission to open a key container and export a certificate when you pass the SerializedCert value to the contentType parameter. Security action: Demand. Associated enumerations: KeyContainerPermissionFlags.Open, KeyContainerPermissionFlags.Export

.NET Framework
Available since 2.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: