X509Certificate::Export Method (X509ContentType)
Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.
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 ); }
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
Available since 2.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0