X509SubjectKeyIdentifierExtension Constructors

Definition

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Initializes a new instance of the X509SubjectKeyIdentifierExtension class.

Overloads

X509SubjectKeyIdentifierExtension()	Initializes a new instance of the X509SubjectKeyIdentifierExtension class.
X509SubjectKeyIdentifierExtension(Byte[], Boolean)	Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a byte array and a value that identifies whether the extension is critical.
X509SubjectKeyIdentifierExtension(ReadOnlySpan<Byte>, Boolean)	Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a read-only span of bytes and a value that identifies whether the extension is critical.
X509SubjectKeyIdentifierExtension(AsnEncodedData, Boolean)	Initializes a new instance of the X509SubjectKeyIdentifierExtension class using encoded data and a value that identifies whether the extension is critical.
X509SubjectKeyIdentifierExtension(PublicKey, Boolean)	Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a public key and a value indicating whether the extension is critical.
X509SubjectKeyIdentifierExtension(String, Boolean)	Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a string and a value that identifies whether the extension is critical.
X509SubjectKeyIdentifierExtension(PublicKey, X509SubjectKeyIdentifierHashAlgorithm, Boolean)	Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a public key, a hash algorithm identifier, and a value indicating whether the extension is critical.

X509SubjectKeyIdentifierExtension()

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class.

public:
 X509SubjectKeyIdentifierExtension();

public X509SubjectKeyIdentifierExtension ();

Public Sub New ()

Examples

The following code example demonstrates how to open a user's personal certificate store and display information about each certificate in the store. This example uses the X509SubjectKeyIdentifierExtension class to display the information.

#using <System.dll>
#using <system.security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store^ store = gcnew X509Store( L"MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      for ( int i = 0; i < collection->Count; i++ )
      {
         System::Collections::IEnumerator^ myEnum = collection[ i ]->Extensions->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            X509Extension^ extension = safe_cast<X509Extension^>(myEnum->Current);
            Console::WriteLine( L"{0}({1})", extension->Oid->FriendlyName, extension->Oid->Value );
            if ( extension->Oid->FriendlyName == L"Key Usage" )
            {
               X509KeyUsageExtension^ ext = dynamic_cast<X509KeyUsageExtension^>(extension);
               Console::WriteLine( ext->KeyUsages );
            }
            if ( extension->Oid->FriendlyName == L"Basic Constraints" )
            {
               X509BasicConstraintsExtension^ ext = dynamic_cast<X509BasicConstraintsExtension^>(extension);
               Console::WriteLine( ext->CertificateAuthority );
               Console::WriteLine( ext->HasPathLengthConstraint );
               Console::WriteLine( ext->PathLengthConstraint );
            }
            if ( extension->Oid->FriendlyName == L"Subject Key Identifier" )
            {
               X509SubjectKeyIdentifierExtension^ ext = dynamic_cast<X509SubjectKeyIdentifierExtension^>(extension);
               Console::WriteLine( ext->SubjectKeyIdentifier );
            }
            if ( extension->Oid->FriendlyName == L"Enhanced Key Usage" )
            {
               X509EnhancedKeyUsageExtension^ ext = dynamic_cast<X509EnhancedKeyUsageExtension^>(extension);
               OidCollection^ oids = ext->EnhancedKeyUsages;
               System::Collections::IEnumerator^ myEnum1 = oids->GetEnumerator();
               while ( myEnum1->MoveNext() )
               {
                  Oid^ oid = safe_cast<Oid^>(myEnum1->Current);
                  Console::WriteLine( L"{0}({1})", oid->FriendlyName, oid->Value );
               }
            }
         }

      }
      store->Close();
   }
   catch ( CryptographicException^ ) 
   {
      Console::WriteLine( L"Information could not be written out for this certificate." );
   }

}

using System;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;

public class CertSelect
{
    public static void Main()
    {
        try
        {
            X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
            store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);

            X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
            for (int i = 0; i < collection.Count; i++)
            {
                foreach (X509Extension extension in collection[i].Extensions)
                {
                    Console.WriteLine(extension.Oid.FriendlyName + "(" + extension.Oid.Value + ")");

                    if (extension.Oid.FriendlyName == "Key Usage")
                    {
                        X509KeyUsageExtension ext = (X509KeyUsageExtension)extension;
                        Console.WriteLine(ext.KeyUsages);
                    }

                    if (extension.Oid.FriendlyName == "Basic Constraints")
                    {
                        X509BasicConstraintsExtension ext = (X509BasicConstraintsExtension)extension;
                        Console.WriteLine(ext.CertificateAuthority);
                        Console.WriteLine(ext.HasPathLengthConstraint);
                        Console.WriteLine(ext.PathLengthConstraint);
                    }

                    if (extension.Oid.FriendlyName == "Subject Key Identifier")
                    {
                        X509SubjectKeyIdentifierExtension ext = (X509SubjectKeyIdentifierExtension)extension;
                        Console.WriteLine(ext.SubjectKeyIdentifier);
                    }

                    if (extension.Oid.FriendlyName == "Enhanced Key Usage")
                    {
                        X509EnhancedKeyUsageExtension ext = (X509EnhancedKeyUsageExtension)extension;
                        OidCollection oids = ext.EnhancedKeyUsages;
                        foreach (Oid oid in oids)
                        {
                            Console.WriteLine(oid.FriendlyName + "(" + oid.Value + ")");
                        }
                    }
                }
            }
            store.Close();
        }
        catch (CryptographicException)
        {
            Console.WriteLine("Information could not be written out for this certificate.");
        }
    }
}

Imports System.Security.Cryptography
Imports System.Security.Cryptography.X509Certificates



Module CertSelect

    Sub Main()
        Try
            Dim store As New X509Store("MY", StoreLocation.CurrentUser)
            store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)

            Dim collection As X509Certificate2Collection = CType(store.Certificates, X509Certificate2Collection)
            For i As Integer = 0 To collection.Count - 1
                Dim extension As X509Extension
                For Each extension In collection(i).Extensions
                    Console.WriteLine(extension.Oid.FriendlyName + "(" + extension.Oid.Value + ")")


                    If extension.Oid.FriendlyName = "Key Usage" Then
                        Dim ext As X509KeyUsageExtension = CType(extension, X509KeyUsageExtension)
                        Console.WriteLine(ext.KeyUsages)
                    End If

                    If extension.Oid.FriendlyName = "Basic Constraints" Then
                        Dim ext As X509BasicConstraintsExtension = CType(extension, X509BasicConstraintsExtension)
                        Console.WriteLine(ext.CertificateAuthority)
                        Console.WriteLine(ext.HasPathLengthConstraint)
                        Console.WriteLine(ext.PathLengthConstraint)
                    End If

                    If extension.Oid.FriendlyName = "Subject Key Identifier" Then
                        Dim ext As X509SubjectKeyIdentifierExtension = CType(extension, X509SubjectKeyIdentifierExtension)
                        Console.WriteLine(ext.SubjectKeyIdentifier)
                    End If

                    If extension.Oid.FriendlyName = "Enhanced Key Usage" Then
                        Dim ext As X509EnhancedKeyUsageExtension = CType(extension, X509EnhancedKeyUsageExtension)
                        Dim oids As OidCollection = ext.EnhancedKeyUsages
                        Dim oid As Oid
                        For Each oid In oids
                            Console.WriteLine(oid.FriendlyName + "(" + oid.Value + ")")
                        Next oid
                    End If
                Next extension
            Next i
            store.Close()
        Catch
            Console.WriteLine("Information could not be written out for this certificate.")
        End Try

    End Sub
End Module

X509SubjectKeyIdentifierExtension(Byte[], Boolean)

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a byte array and a value that identifies whether the extension is critical.

public:
 X509SubjectKeyIdentifierExtension(cli::array <System::Byte> ^ subjectKeyIdentifier, bool critical);

public X509SubjectKeyIdentifierExtension (byte[] subjectKeyIdentifier, bool critical);

new System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension : byte[] * bool -> System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension

Public Sub New (subjectKeyIdentifier As Byte(), critical As Boolean)

Parameters

subjectKeyIdentifier

Byte[]

A byte array that represents data to use to create the extension.

critical

Boolean

true if the extension is critical; otherwise, false.

X509SubjectKeyIdentifierExtension(ReadOnlySpan<Byte>, Boolean)

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a read-only span of bytes and a value that identifies whether the extension is critical.

public:
 X509SubjectKeyIdentifierExtension(ReadOnlySpan<System::Byte> subjectKeyIdentifier, bool critical);

public X509SubjectKeyIdentifierExtension (ReadOnlySpan<byte> subjectKeyIdentifier, bool critical);

new System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension : ReadOnlySpan<byte> * bool -> System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension

Public Sub New (subjectKeyIdentifier As ReadOnlySpan(Of Byte), critical As Boolean)

Parameters

subjectKeyIdentifier

ReadOnlySpan<Byte>

A read-only span of bytes that represents data to use to create the extension.

critical

Boolean

true if the extension is critical; otherwise, false.

X509SubjectKeyIdentifierExtension(AsnEncodedData, Boolean)

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class using encoded data and a value that identifies whether the extension is critical.

public:
 X509SubjectKeyIdentifierExtension(System::Security::Cryptography::AsnEncodedData ^ encodedSubjectKeyIdentifier, bool critical);

public X509SubjectKeyIdentifierExtension (System.Security.Cryptography.AsnEncodedData encodedSubjectKeyIdentifier, bool critical);

new System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension : System.Security.Cryptography.AsnEncodedData * bool -> System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension

Public Sub New (encodedSubjectKeyIdentifier As AsnEncodedData, critical As Boolean)

Parameters

encodedSubjectKeyIdentifier

AsnEncodedData

The AsnEncodedData object to use to create the extension.

critical

Boolean

true if the extension is critical; otherwise, false.

Remarks

Use this constructor if the information to create the extension is already in an AsnEncodedData object.

X509SubjectKeyIdentifierExtension(PublicKey, Boolean)

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a public key and a value indicating whether the extension is critical.

public:
 X509SubjectKeyIdentifierExtension(System::Security::Cryptography::X509Certificates::PublicKey ^ key, bool critical);

public X509SubjectKeyIdentifierExtension (System.Security.Cryptography.X509Certificates.PublicKey key, bool critical);

new System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension : System.Security.Cryptography.X509Certificates.PublicKey * bool -> System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension

Public Sub New (key As PublicKey, critical As Boolean)

Parameters

key

PublicKey

A PublicKey object to create a subject key identifier (SKI) from.

critical

Boolean

true if the extension is critical; otherwise, false.

X509SubjectKeyIdentifierExtension(String, Boolean)

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a string and a value that identifies whether the extension is critical.

public:
 X509SubjectKeyIdentifierExtension(System::String ^ subjectKeyIdentifier, bool critical);

public X509SubjectKeyIdentifierExtension (string subjectKeyIdentifier, bool critical);

new System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension : string * bool -> System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension

Public Sub New (subjectKeyIdentifier As String, critical As Boolean)

Parameters

subjectKeyIdentifier

String

A string, encoded in hexadecimal format, that represents the subject key identifier (SKI) for a certificate.

critical

Boolean

true if the extension is critical; otherwise, false.

Remarks

The subject key identifier (SKI) can be used to identify the certificate and is often used when working with XML digital signing.

X509SubjectKeyIdentifierExtension(PublicKey, X509SubjectKeyIdentifierHashAlgorithm, Boolean)

Source:

X509SubjectKeyIdentifierExtension.cs

Initializes a new instance of the X509SubjectKeyIdentifierExtension class using a public key, a hash algorithm identifier, and a value indicating whether the extension is critical.

public:
 X509SubjectKeyIdentifierExtension(System::Security::Cryptography::X509Certificates::PublicKey ^ key, System::Security::Cryptography::X509Certificates::X509SubjectKeyIdentifierHashAlgorithm algorithm, bool critical);

public X509SubjectKeyIdentifierExtension (System.Security.Cryptography.X509Certificates.PublicKey key, System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierHashAlgorithm algorithm, bool critical);

new System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension : System.Security.Cryptography.X509Certificates.PublicKey * System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierHashAlgorithm * bool -> System.Security.Cryptography.X509Certificates.X509SubjectKeyIdentifierExtension

Public Sub New (key As PublicKey, algorithm As X509SubjectKeyIdentifierHashAlgorithm, critical As Boolean)

Parameters

key

PublicKey

A PublicKey object to create a subject key identifier (SKI) from.

algorithm

X509SubjectKeyIdentifierHashAlgorithm

One of the X509SubjectKeyIdentifierHashAlgorithm values that identifies which hash algorithm to use.

critical

Boolean

true if the extension is critical; otherwise, false.