X500DistinguishedName Kelas

Definisi

Ruang nama:

System.Security.Cryptography.X509Certificates

Rakitan:

System.Security.Cryptography.dll

Sumber:

X500DistinguishedName.cs

Mewakili nama yang dibedakan dari sertifikat X509. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

AsnEncodedData

X500DistinguishedName

Contoh

Contoh kode berikut menunjukkan cara menggunakan X500DistinguishedName kelas .

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

Keterangan

Kelas ini seperti ekstensi ke SubjectName properti atau IssuerName , yang merupakan nama orang atau entitas tempat sertifikat dikeluarkan. X.500 adalah standar internasional untuk layanan direktori terdistribusi. Nama yang dibedakan menggunakan format berikut:

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

Batas panjang bidang berikut berlaku:

Bidang	Batas Panjang
CountryCode	2 karakter
Organisasi	Hingga 64 karakter
OrganizationUnit	Hingga 32 karakter
CommonName	Hingga 64 karakter

Panduan berikut berlaku:

• Nilai bidang bisa huruf besar atau huruf kecil.

• Pemisah adalah tanda garis miring (/) dan harus muncul sebelum nilai pertama dan di antara nilai berikutnya.

• Pemisah dapat diikuti oleh spasi.

Berikut ini adalah contoh nama yang diformat dengan benar: [X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt]

Konstruktor

X500DistinguishedName(AsnEncodedData)	Menginisialisasi instans X500DistinguishedName baru kelas menggunakan objek yang ditentukan AsnEncodedData .
X500DistinguishedName(Byte[])	Menginisialisasi instans X500DistinguishedName baru kelas menggunakan informasi dari array byte yang ditentukan.
X500DistinguishedName(ReadOnlySpan<Byte>)	Menginisialisasi instans X500DistinguishedName baru kelas menggunakan informasi dari data yang disediakan.
X500DistinguishedName(String)	Menginisialisasi instans X500DistinguishedName baru kelas menggunakan informasi dari string yang ditentukan.
X500DistinguishedName(String, X500DistinguishedNameFlags)	Menginisialisasi instans X500DistinguishedName baru kelas menggunakan string dan X500DistinguishedNameFlags bendera yang ditentukan.
X500DistinguishedName(X500DistinguishedName)	Menginisialisasi instans X500DistinguishedName baru kelas menggunakan objek yang ditentukan X500DistinguishedName .

Properti

Name	Mendapatkan nama pembeda yang dibatasi koma dari sertifikat X500.
Oid	Mendapatkan atau mengatur Oid nilai untuk objek AsnEncodedData . (Diperoleh dari AsnEncodedData)
RawData	Mendapatkan atau mengatur data yang dikodekan Abstract Syntax Notation One (ASN.1) yang direpresentasikan dalam array byte. (Diperoleh dari AsnEncodedData)

Metode

CopyFrom(AsnEncodedData)	Menyalin informasi dari objek AsnEncodedData . (Diperoleh dari AsnEncodedData)
Decode(X500DistinguishedNameFlags)	Mendekode nama khusus menggunakan karakteristik yang ditentukan oleh flag parameter .
EnumerateRelativeDistinguishedNames(Boolean)	Melakukan iterasi atas nilai RelativeDistinguishedName dalam nilai nama yang dibedakan ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Format(Boolean)	Mengembalikan versi terformat dari nama khusus X500 untuk pencetakan atau output ke jendela teks atau ke konsol.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)