X500DistinguishedName Sınıf

Tanım

Ad Alanı:

System.Security.Cryptography.X509Certificates

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Kaynak:

X500DistinguishedName.cs

X509 sertifikasının ayırt edici adını temsil eder. Bu sınıf devralınamaz.

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

Devralma

Object

AsnEncodedData

X500DistinguishedName

Örnekler

Aşağıdaki kod örneği sınıfının nasıl kullanılacağını X500DistinguishedName gösterir.

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

Açıklamalar

Bu sınıf, sertifikanın SubjectName verildiği kişinin veya varlığın adı olan veya IssuerName özelliğinin uzantısı gibidir. X.500, dağıtılmış dizin hizmetleri için uluslararası bir standarttır. Ayırt edici ad aşağıdaki biçimi kullanır:

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

Aşağıdaki alan uzunluğu sınırları geçerlidir:

Alan	Uzunluk Sınırı
CountryCode	2 karakter
Kuruluş	En fazla 64 karakter
OrganizationUnit	En fazla 32 karakter
CommonName	En fazla 64 karakter

Aşağıdaki kurallar uygulanır:

• Alan değerleri büyük veya küçük harf olabilir.

• Sınırlayıcılar eğik çizgi işaretleridir (/) ve ilk değerden önce ve izleyen değerler arasında görünmelidir.

• Sınırlayıcıları bir boşluk takip edebilir.

Aşağıda doğru biçimlendirilmiş bir ad örneği verilmiştir: [X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]

Oluşturucular

X500DistinguishedName(AsnEncodedData)	Belirtilen AsnEncodedData nesneyi kullanarak sınıfının yeni bir örneğini X500DistinguishedName başlatır.
X500DistinguishedName(Byte[])	Belirtilen bayt dizisinden X500DistinguishedName bilgileri kullanarak sınıfının yeni bir örneğini başlatır.
X500DistinguishedName(ReadOnlySpan<Byte>)	Sağlanan verilerden alınan bilgileri kullanarak sınıfının yeni bir örneğini X500DistinguishedName başlatır.
X500DistinguishedName(String)	Belirtilen dizedeki bilgileri kullanarak sınıfının yeni bir örneğini X500DistinguishedName başlatır.
X500DistinguishedName(String, X500DistinguishedNameFlags)	Belirtilen dize ve X500DistinguishedNameFlags bayrağını kullanarak sınıfının yeni bir örneğini X500DistinguishedName başlatır.
X500DistinguishedName(X500DistinguishedName)	Belirtilen X500DistinguishedName nesneyi kullanarak sınıfının yeni bir örneğini X500DistinguishedName başlatır.

Özellikler

Name	X500 sertifikasından virgülle ayrılmış ayırt edici adı alır.
Oid	Bir AsnEncodedData nesnenin Oid değerini alır veya ayarlar. (Devralındığı yer: AsnEncodedData)
RawData	Bir bayt dizisinde temsil edilen Soyut Söz Dizimi Gösterimi Bir (ASN.1) ile kodlanmış verileri alır veya ayarlar. (Devralındığı yer: AsnEncodedData)

Yöntemler

CopyFrom(AsnEncodedData)	Bir AsnEncodedData nesneden bilgileri kopyalar. (Devralındığı yer: AsnEncodedData)
Decode(X500DistinguishedNameFlags)	parametresi tarafından belirtilen özellikleri kullanarak ayırt edici bir adın kodunu çözer flag .
EnumerateRelativeDistinguishedNames(Boolean)	Bu ayırt edici ad değeri içindeki RelativeDistinguishedName değerlerini yineler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Format(Boolean)	Bir metin penceresine veya konsola yazdırmak veya çıktı almak için X500 ayırt edici adının biçimlendirilmiş bir sürümünü döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)