X500DistinguishedName Classe
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o nome diferenciado de um certificado X509. Essa classe não pode ser herdada.
public ref class X500DistinguishedName sealed : System::Security::Cryptography::AsnEncodedData
public sealed class X500DistinguishedName : System.Security.Cryptography.AsnEncodedData
type X500DistinguishedName = class
inherit AsnEncodedData
Public NotInheritable Class X500DistinguishedName
Inherits AsnEncodedData
- Herança
O exemplo de código a seguir mostra como usar a X500DistinguishedName classe .
using System;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
class X500Sample
{
static void Main()
{
try
{
X509Store store = new("MY", StoreLocation.CurrentUser);
store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
X509Certificate2Collection collection = store.Certificates;
X509Certificate2Collection fcollection = collection.Find(
X509FindType.FindByTimeValid,
DateTime.Now, false
);
X509Certificate2Collection scollection = X509Certificate2UI.SelectFromCollection(
fcollection,
"Test Certificate Select",
"Select a certificate from the following list to get information on that certificate",
X509SelectionFlag.MultiSelection
);
Console.WriteLine($"Number of certificates: {scollection.Count}{Environment.NewLine}");
foreach (X509Certificate2 x509 in scollection)
{
X500DistinguishedName dname = new(
x509.SubjectName.Name,
X500DistinguishedNameFlags.Reversed | X500DistinguishedNameFlags.UseSemicolons
);
Console.WriteLine("X500DistinguishedName: {0}{1}", dname.Name, Environment.NewLine);
x509.Reset();
}
store.Close();
}
catch (CryptographicException)
{
Console.WriteLine("Information could not be written out for this certificate.");
}
}
}
Imports System.Security.Cryptography.X509Certificates
Class X500Sample
Shared s_msg As String
Shared Sub Main()
Try
Dim store As New X509Store("MY", StoreLocation.CurrentUser)
store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)
Dim collection As X509Certificate2Collection = store.Certificates
Dim fcollection As X509Certificate2Collection = collection.Find(X509FindType.FindByTimeValid, Date.Now, False)
Dim scollection As X509Certificate2Collection = X509Certificate2UI.SelectFromCollection(
fcollection,
"Test Certificate Select",
"Select a certificate from the following list to get information on that certificate",
X509SelectionFlag.MultiSelection
)
s_msg = "Number of certificates: " & scollection.Count & Environment.NewLine
Console.WriteLine(s_msg)
Dim x509 As X509Certificate2
For Each x509 In scollection
Dim dname As New X500DistinguishedName(
x509.SubjectName.Name,
X500DistinguishedNameFlags.Reversed Or X500DistinguishedNameFlags.UseSemicolons
)
s_msg = "X500DistinguishedName: " & dname.Name & Environment.NewLine
Console.WriteLine(s_msg)
x509.Reset()
Next x509
store.Close()
Catch e As Exception
s_msg = "Error: Information could not be written out for this certificate."
Console.WriteLine(s_msg)
End Try
End Sub
End Class
Essa classe é como uma extensão para a SubjectName propriedade ou IssuerName , que é o nome da pessoa ou entidade para a qual o certificado está sendo emitido. O X.500 é um padrão internacional para serviços de diretório distribuído. O nome diferenciado usa o seguinte formato:
[X500:/C=CountryCode/O=Organization/OU=OrganizationUnit/CN=CommonName]
Os seguintes limites de comprimento de campo se aplicam:
Campo | Limite de comprimento |
---|---|
CountryCode | 2 caracteres |
Organização | Até 64 caracteres |
OrganizationUnit | Até 32 caracteres |
Commonname | Até 64 caracteres |
As seguintes diretrizes se aplicam:
Os valores de campo podem ser maiúsculos ou minúsculos.
Os delimitadores são marcas de barra (/) e devem aparecer antes do primeiro valor e entre os valores subsequentes.
Os delimitadores podem ser seguidos por um espaço.
Veja a seguir um exemplo de um nome formatado corretamente: [X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]
X500Distinguished |
Inicializa uma nova instância da classe X500DistinguishedName usando o objeto AsnEncodedData especificado. |
X500Distinguished |
Inicializa uma nova instância da classe X500DistinguishedName usando informações da matriz de bytes especificada. |
X500Distinguished |
Inicializa uma nova instância da classe X500DistinguishedName usando informações dos dados fornecidos. |
X500Distinguished |
Inicializa uma nova instância da classe X500DistinguishedName usando informações da cadeia de caracteres especificada. |
X500Distinguished |
Inicializa uma nova instância da classe X500DistinguishedName usando a cadeia de caracteres e o sinalizador X500DistinguishedNameFlags especificados. |
X500Distinguished |
Inicializa uma nova instância da classe X500DistinguishedName usando o objeto X500DistinguishedName especificado. |
Name |
Obtém o nome diferenciado delimitado por vírgula de um certificado X500. |
Oid |
Obtém ou define o valor Oid para um objeto AsnEncodedData. (Herdado de AsnEncodedData) |
Raw |
Obtém ou define os dados codificados em ASN.1 (Abstract Syntax Notation One) representados em uma matriz de bytes. (Herdado de AsnEncodedData) |
Copy |
Copia informações de um objeto AsnEncodedData. (Herdado de AsnEncodedData) |
Decode(X500Distinguished |
Decodifica um nome diferenciado usando as características especificadas pelo parâmetro |
Enumerate |
Itera sobre os valores RelativeDistinguishedName dentro desse valor de nome diferenciado. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
Format(Boolean) |
Retorna uma versão formatada de um nome diferenciado do X500 de impressão ou de saída para uma janela de texto ou para um console. |
Get |
Serve como a função de hash padrão. (Herdado de Object) |
Get |
Obtém o Type da instância atual. (Herdado de Object) |
Memberwise |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
To |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: