X500DistinguishedName クラス

.NET Framework クラス ライブラリ リファレンス

X500DistinguishedName クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

X509 証明書の識別名を表します。このクラスは継承できません。

名前空間: System.Security.Cryptography.X509Certificates
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 X500DistinguishedName
    Inherits AsnEncodedData

Visual Basic (使用法)

Dim instance As X500DistinguishedName

C#

public sealed class X500DistinguishedName :
 AsnEncodedData

C++

public ref class X500DistinguishedName sealed
 : public AsnEncodedData

J#

public final class X500DistinguishedName extends
 AsnEncodedData

JScript

public final class X500DistinguishedName extends
 AsnEncodedData

解説

このクラスは、SubjectName プロパティ (発行された証明書を受け取る主体者名) や IssuerName プロパティ (証明書の発行者名) に対する拡張機能のようなものです。X.500 は、分散ディレクトリ サービスの国際標準となっています。識別名には次の形式が使用されます。

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

フィールド長は、次のように制限されています。

フィールド	長さ制限
CountryCode	2 文字
Organization	最大 64 文字
OrganizationUnit	最大 32 文字
CommonName	最大 64 文字

次のガイドラインが適用されます。

• フィールド値には大文字と小文字を使用できる。

• 区切り記号にはスラッシュ (/) を使用し、1 つ目の値の前、および、後続の各値間に指定する。

• 区切り記号の後にスペースを含めることができる。

たとえば、[X500:/ C=US/ O=Microsoft/ OU=WGA/ CN=TedSt] のように指定します。

使用例

X500DistinguishedName クラスを使用するコード例を次に示します。

Visual Basic

Imports System
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 'Main 
End Class 'X500Sample

C#

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.");
        }

    }
}

C++

#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." );
   }

}

継承階層

System.Object
   System.Security.Cryptography.AsnEncodedData
    System.Security.Cryptography.X509Certificates.X500DistinguishedName

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
X500DistinguishedName メンバ
System.Security.Cryptography.X509Certificates 名前空間