X509Certificate::Export Method (X509ContentType)

 

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)

public:
[ComVisibleAttribute(false)]
virtual array<unsigned char>^ Export(
	X509ContentType contentType
)

Parameters

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

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

Return Value

Type: array<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.

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

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: