X509SubjectKeyIdentifierExtension Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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()
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
Applies to
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.
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.X509SubjectKeyIdentifierExtensionPublic 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.
Applies to
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.
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.X509SubjectKeyIdentifierExtensionPublic 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.
Applies to
X509SubjectKeyIdentifierExtension(AsnEncodedData, Boolean)
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.X509SubjectKeyIdentifierExtensionPublic 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.
Applies to
X509SubjectKeyIdentifierExtension(PublicKey, Boolean)
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.X509SubjectKeyIdentifierExtensionPublic Sub New (key As PublicKey, critical As Boolean)Parameters
- critical
- Boolean
true if the extension is critical; otherwise, false.
Applies to
X509SubjectKeyIdentifierExtension(String, Boolean)
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.X509SubjectKeyIdentifierExtensionPublic 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.
Applies to
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.
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.X509SubjectKeyIdentifierExtensionPublic Sub New (key As PublicKey, algorithm As X509SubjectKeyIdentifierHashAlgorithm, critical As Boolean)Parameters
- algorithm
- X509SubjectKeyIdentifierHashAlgorithm
One of the X509SubjectKeyIdentifierHashAlgorithm values that identifies which hash algorithm to use.
- critical
- Boolean
true if the extension is critical; otherwise, false.
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for