X500DistinguishedName Klasse

Definition

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Quelle:

X500DistinguishedName.cs

Stellt den Distinguished Name eines X 509-Zertifikats dar. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

AsnEncodedData

X500DistinguishedName

Beispiele

Im folgenden Codebeispiel wird die Verwendung der X500DistinguishedName-Klasse veranschaulicht.

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

Hinweise

Diese Klasse ähnelt einer Erweiterung der SubjectName - oder IssuerName -Eigenschaft. Dies ist der Name der Person oder Entität, für die das Zertifikat ausgestellt wird. X.500 ist ein internationaler Standard für verteilte Verzeichnisdienste. Der distinguished Name verwendet das folgende Format:

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

Es gelten die folgenden Feldlängengrenzwerte:

Feld	Längenlimit
CountryCode	2 Zeichen
Organization	Bis zu 64 Zeichen
OrganizationUnit	Bis zu 32 Zeichen
CommonName	Bis zu 64 Zeichen

Es gelten die folgenden Richtlinien:

• Feldwerte können Groß- oder Kleinbuchstaben sein.

• Trennzeichen sind Schrägstriche (/) und müssen vor dem ersten Wert und zwischen nachfolgenden Werten angezeigt werden.

• Auf Trennzeichen kann ein Leerzeichen folgen.

Es folgt ein Beispiel für einen ordnungsgemäß formatierten Namen: [X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]

Konstruktoren

X500DistinguishedName(AsnEncodedData)	Initialisiert eine neue Instanz der X500DistinguishedName-Klasse mit dem angegebenen AsnEncodedData-Objekt.
X500DistinguishedName(Byte[])	Initialisiert eine neue Instanz der X500DistinguishedName-Klasse unter Verwendung des angegebenen Bytearrays.
X500DistinguishedName(ReadOnlySpan<Byte>)	Initialisiert eine neue Instanz der X500DistinguishedName-Klasse unter Verwendung von Informationen aus den bereitgestellten Daten.
X500DistinguishedName(String)	Initialisiert eine neue Instanz der X500DistinguishedName-Klasse unter Verwendung von Informationen aus der angegebenen Zeichenfolge.
X500DistinguishedName(String, X500DistinguishedNameFlags)	Initialisiert eine neue Instanz der X500DistinguishedName-Klasse unter Verwendung der angegebenen Zeichenfolge und des X500DistinguishedNameFlags-Flags.
X500DistinguishedName(X500DistinguishedName)	Initialisiert eine neue Instanz der X500DistinguishedName-Klasse mit dem angegebenen X500DistinguishedName-Objekt.

Eigenschaften

Name	Ruft den durch Kommas getrennten Distinguished Name aus einem X500-Zertifikat ab.
Oid	Ruft den Oid-Wert für ein AsnEncodedData-Objekt ab oder legt diesen fest. (Geerbt von AsnEncodedData)
RawData	Ruft die in einem Bytearray dargestellten ASN.1-codierten (Abstract Syntax Notation One) Daten ab oder legt diese fest. (Geerbt von AsnEncodedData)

Methoden

CopyFrom(AsnEncodedData)	Kopiert Informationen aus einem AsnEncodedData-Objekt. (Geerbt von AsnEncodedData)
Decode(X500DistinguishedNameFlags)	Decodiert einen Distinguished Name mit dem vom flag-Parameter angegebenen Merkmal.
EnumerateRelativeDistinguishedNames(Boolean)	Durchläuft die RelativeDistinguishedName-Werte innerhalb dieses Distinguished Name-Werts.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Format(Boolean)	Gibt eine formatierte Version für einen X500-Distinguished Name zurück, der gedruckt oder in einem Textfenster oder einer Konsole ausgegeben werden kann.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)