X509KeyUsageExtension Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет использование ключа, содержащегося в сертификате X.509. Этот класс не наследуется.
public ref class X509KeyUsageExtension sealed : System::Security::Cryptography::X509Certificates::X509Extension
public sealed class X509KeyUsageExtension : System.Security.Cryptography.X509Certificates.X509Extension
type X509KeyUsageExtension = class
inherit X509Extension
Public NotInheritable Class X509KeyUsageExtension
Inherits X509Extension
- Наследование
Примеры
В следующем примере кода показано, как открыть личное хранилище сертификатов пользователя и отобразить сведения о каждом сертификате в хранилище. В этом примере для отображения сведений X509KeyUsageExtension используется класс.
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
Комментарии
Класс X509KeyUsageExtension использует флаги перечисления X509KeyUsageFlags для определения или определения использования ключа.
Конструкторы
| Имя | Описание |
|---|---|
| X509KeyUsageExtension() |
Инициализирует новый экземпляр класса X509KeyUsageExtension. |
| X509KeyUsageExtension(AsnEncodedData, Boolean) |
Инициализирует новый экземпляр X509KeyUsageExtension класса с помощью AsnEncodedData объекта и значения, определяющего, является ли расширение критически важным. |
| X509KeyUsageExtension(X509KeyUsageFlags, Boolean) |
Инициализирует новый экземпляр класса с помощью указанного X509KeyUsageExtensionX509KeyUsageFlags значения и значения, определяющего, является ли расширение критически важным. |
Свойства
| Имя | Описание |
|---|---|
| Critical |
Возвращает логическое значение, указывающее, является ли расширение критически важным. (Унаследовано от X509Extension) |
| KeyUsages |
Возвращает флаг использования ключа, связанный с сертификатом. |
| Oid |
Возвращает или задает Oid значение объекта AsnEncodedData . (Унаследовано от AsnEncodedData) |
| RawData |
Возвращает или задает абстрактные нотации синтаксиса One (ASN.1)- закодированные данные, представленные в массиве байтов. (Унаследовано от AsnEncodedData) |
Методы
| Имя | Описание |
|---|---|
| CopyFrom(AsnEncodedData) |
Инициализирует новый экземпляр X509KeyUsageExtension класса с помощью AsnEncodedData объекта. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| Format(Boolean) |
Возвращает форматированную версию нотации абстрактного синтаксиса (ASN.1) в виде строки. (Унаследовано от AsnEncodedData) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |