X509Certificate::GetSerialNumber Method ()


Returns the serial number of the X.509v3 certificate as an array of bytes.

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

virtual array<unsigned char>^ GetSerialNumber()

Return Value

Type: array<System::Byte>^

The serial number of the X.509 certificate as an array of bytes.

Exception Condition

The certificate context is invalid.

The following example uses the GetSerialNumber method to return a certificate's serial number as an array of bytes and displays it to the console.

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()

   // The path to the certificate.
   String^ Certificate = "Certificate.cer";

   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = X509Certificate::CreateFromCertFile( Certificate );

   // Get the value.
   array<Byte>^results = cert->GetSerialNumber();

   // Display the value to the console.
   System::Collections::IEnumerator^ enum0 = results->GetEnumerator();
   while ( enum0->MoveNext() )
      Byte b = safe_cast<Byte>(enum0->Current);
      Console::Write( b );

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