X509SubjectKeyIdentifierExtension 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
多載
X509SubjectKeyIdentifierExtension() |
初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension(Byte[], Boolean) |
使用位元組陣列和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension(ReadOnlySpan<Byte>, Boolean) |
使用唯讀位元組範圍和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension(AsnEncodedData, Boolean) |
使用已編碼的資料和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension(PublicKey, Boolean) |
使用公開金鑰 (Public Key) 和指出擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension(String, Boolean) |
使用字串和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension(PublicKey, X509SubjectKeyIdentifierHashAlgorithm, Boolean) |
使用公開金鑰、雜湊演算法識別項和指出擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。 |
X509SubjectKeyIdentifierExtension()
初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
public:
X509SubjectKeyIdentifierExtension();
public X509SubjectKeyIdentifierExtension ();
Public Sub New ()
範例
下列程式代碼範例示範如何開啟使用者的個人證書存儲,以及顯示存放區中每個憑證的相關信息。 這個範例會 X509SubjectKeyIdentifierExtension 使用 類別來顯示資訊。
#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)
使用位元組陣列和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
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)
參數
- subjectKeyIdentifier
- Byte[]
位元組陣列,表示用於建立擴充功能的資料。
- critical
- Boolean
如果是關鍵擴充功能則為 true
,否則為 false
。
適用於
X509SubjectKeyIdentifierExtension(ReadOnlySpan<Byte>, Boolean)
使用唯讀位元組範圍和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
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)
參數
- subjectKeyIdentifier
- ReadOnlySpan<Byte>
唯讀的位元組範圍,表示用於建立擴充功能的資料。
- critical
- Boolean
如果是關鍵擴充功能則為 true
,否則為 false
。
適用於
X509SubjectKeyIdentifierExtension(AsnEncodedData, Boolean)
使用已編碼的資料和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
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)
參數
- encodedSubjectKeyIdentifier
- AsnEncodedData
AsnEncodedData 物件,用於建立擴充功能。
- critical
- Boolean
如果是關鍵擴充功能則為 true
,否則為 false
。
備註
如果建立延伸模組的信息已經在物件中 AsnEncodedData ,請使用這個建構函式。
適用於
X509SubjectKeyIdentifierExtension(PublicKey, Boolean)
使用公開金鑰 (Public Key) 和指出擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
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)
參數
- critical
- Boolean
如果是關鍵擴充功能則為 true
,否則為 false
。
適用於
X509SubjectKeyIdentifierExtension(String, Boolean)
使用字串和識別擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
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)
參數
- subjectKeyIdentifier
- String
以十六進位格式編碼的字串,表示憑證的主體金鑰識別元 (SKI)。
- critical
- Boolean
如果是關鍵擴充功能則為 true
,否則為 false
。
備註
主旨金鑰標識碼 (SKI) 可用來識別憑證,而且通常用於使用 XML 數位簽名時。
適用於
X509SubjectKeyIdentifierExtension(PublicKey, X509SubjectKeyIdentifierHashAlgorithm, Boolean)
使用公開金鑰、雜湊演算法識別項和指出擴充功能是否重要的值,初始化 X509SubjectKeyIdentifierExtension 類別的新執行個體。
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)
參數
- algorithm
- X509SubjectKeyIdentifierHashAlgorithm
其中一個 X509SubjectKeyIdentifierHashAlgorithm 值,可識別要使用的雜湊演算法。
- critical
- Boolean
如果是關鍵擴充功能則為 true
,否則為 false
。