Export (0) Print
Expand All

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)

[ComVisibleAttribute(false)]
public:
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.

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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft