X500DistinguishedName Klasse

Referenz

Definition

Namespace:: System.Security.Cryptography.X509Certificates

Assembly:: System.Security.Cryptography.X509Certificates.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.dll>
#using <system.security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store ^ store = gcnew X509Store( "MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection ^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection ^ fcollection = dynamic_cast<X509Certificate2Collection^>(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: {0}{1}", scollection->Count, Environment::NewLine );
      System::Collections::IEnumerator^ myEnum = scollection->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
         X500DistinguishedName ^ dname = gcnew X500DistinguishedName( x509->SubjectName );
         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." );
   }

}

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class X500Sample
{
    static void Main()
    {
        try
        {
            X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
            store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
            X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
            X509Certificate2Collection fcollection = (X509Certificate2Collection)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: {0}{1}", scollection.Count, Environment.NewLine);
            foreach (X509Certificate2 x509 in scollection)
            {
                X500DistinguishedName dname = new X500DistinguishedName(x509.SubjectName);
                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
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates



Class X500Sample
   Shared 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 = CType(store.Certificates, X509Certificate2Collection)
         Dim fcollection As X509Certificate2Collection = CType(collection.Find(X509FindType.FindByTimeValid, DateTime.Now, False), X509Certificate2Collection)
         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)
     msg = "Number of certificates: " & scollection.Count & Environment.NewLine
     MsgBox(msg)
         Dim x509 As X509Certificate2
         For Each x509 In  scollection
            Dim dname As New X500DistinguishedName(x509.SubjectName)
        msg = "X500DistinguishedName: " & dname.Name & Environment.NewLine
     MsgBox(msg)
            x509.Reset()
         Next x509
         store.Close()
     Catch e As Exception
            msg = "Error: Information could not be written out for this certificate."
            MsgBox(msg)
      End Try
   End Sub
End Class

Hinweise

Diese Klasse ist ähnlich wie eine Erweiterung der SubjectName IssuerName Eigenschaft, die den Namen der Person oder Entität darstellt, an die das Zertifikat ausgestellt wird. X.500 ist ein internationaler Standard für verteilte Verzeichnisdienste. Der unterschiedene Name verwendet das folgende Format:

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

Die folgenden Feldlängenbeschränkungen gelten:

Feld	Längengrenze
CountryCode	2 Zeichen
Organization	Bis zu 64 Zeichen
OrganisationUnit	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.
Trennzeichen können von einem Leerzeichen gefolgt werden.

Nachfolgend sehen Sie ein Beispiel für einen korrekt 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.
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)

Gilt für