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.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

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)