X500DistinguishedName Classe

Définition

Représente le nom unique d’un certificat X509. Cette classe ne peut pas être héritée.

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
Héritage
X500DistinguishedName

Exemples

L'exemple de code suivant montre comment utiliser la classe X500DistinguishedName.

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

Remarques

Cette classe est comme une extension de la SubjectName propriété ou IssuerName , qui est le nom de la personne ou de l’entité à laquelle le certificat est émis. X.500 est une norme internationale pour les services d’annuaire distribués. Le nom unique utilise le format suivant :

[X500 :/C=CountryCode/O=Organization/OU=OrganizationUnit/CN=CommonName]

Les limites de longueur de champ suivantes s’appliquent :

Champ Limite de longueur
CountryCode 2 caractères
Organisation Jusqu’à 64 caractères
OrganizationUnit Jusqu’à 32 caractères
CommonName Jusqu’à 64 caractères

Les consignes suivantes s'appliquent :

  • Les valeurs de champ peuvent être majuscules ou minuscules.

  • Les délimiteurs sont des barres obliques (/) et doivent apparaître avant la première valeur et entre les valeurs suivantes.

  • Les délimiteurs peuvent être suivis d’un espace.

Voici un exemple de nom correctement mis en forme : [X500 :/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]

Constructeurs

X500DistinguishedName(AsnEncodedData)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de l'objet AsnEncodedData spécifié.

X500DistinguishedName(Byte[])

Initialise une nouvelle instance de la classe X500DistinguishedName avec les informations du tableau d'octets spécifié.

X500DistinguishedName(ReadOnlySpan<Byte>)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide d'informations provenant des données fournies.

X500DistinguishedName(String)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide d'informations provenant de la chaîne spécifiée.

X500DistinguishedName(String, X500DistinguishedNameFlags)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de la chaîne et de l'indicateur X500DistinguishedNameFlags spécifiés.

X500DistinguishedName(X500DistinguishedName)

Initialise une nouvelle instance de la classe X500DistinguishedName à l'aide de l'objet X500DistinguishedName spécifié.

Propriétés

Name

Obtient le nom unique délimité par des virgules d'un certificat X500.

Oid

Obtient ou définit la valeur Oid pour un objet AsnEncodedData.

(Hérité de AsnEncodedData)
RawData

Obtient ou définit les données encodées ASN.1 (Abstract Syntax Notation One) représentées dans un tableau d'octets.

(Hérité de AsnEncodedData)

Méthodes

CopyFrom(AsnEncodedData)

Copie les informations d'un objet AsnEncodedData.

(Hérité de AsnEncodedData)
Decode(X500DistinguishedNameFlags)

Décode un nom unique à l'aide des caractéristiques spécifiées par le paramètre flag.

EnumerateRelativeDistinguishedNames(Boolean)

Itère sur les valeurs RelativeDistinguishedName au sein de cette valeur de nom unique.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Format(Boolean)

Retourne une version mise en forme d'un nom unique X500 pour impression ou sortie dans une fenêtre de texte ou une console.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à