X509Chain

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

X509Chain クラス

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

X509Certificate2 証明書のチェーン作成エンジンを表します。

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

Visual Basic (宣言)

Public Class X509Chain

Visual Basic (使用法)

Dim instance As X509Chain

C#

public class X509Chain

C++

public ref class X509Chain

J#

public class X509Chain

JScript

public class X509Chain

解説

X509Chain オブジェクトには、ChainStatus と呼ばれるグローバルなエラー状態があります。このエラー状態は、証明書の検証に使用する必要があります。証明書の検証を管理する規則は複雑ですが、関係する 1 つ以上の要素のエラー状態を無視すると、検証ロジックを単純化しすぎることになります。グローバルなエラー状態では、チェーン内の各要素の状態が考慮されます。

使用例

現在のユーザーの個人用証明書ストアを開いて、証明書を選択できるようにし、証明書および証明書チェーン情報をコンソールに出力するコード例を次に示します。出力は、選択した証明書に依存します。

C#

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

class TestX509Chain
{
    static void Main(string[]
 args)
    {
        //Create new X509 store from local certificate store.
        X509Store store = new X509Store("MY", StoreLocation.CurrentUser);
        store.Open(OpenFlags.OpenExistingOnly | OpenFlags.ReadWrite);

        //Output store information.
        Console.WriteLine ("Store Information");
        Console.WriteLine ("Number of certificates in the
 store: {0}", store.Certificates.Count);
        Console.WriteLine ("Store location: {0}", store.Location);
        Console.WriteLine ("Store name: {0} {1}", store.Name, Environment.NewLine);
    
        //Put certificates from the store into a collection so user
 can select one.
        X509Certificate2Collection fcollection = (X509Certificate2Collection)store.Certificates;
        X509Certificate2Collection collection = X509Certificate2UI.SelectFromCollection(fcollection,
 "Select an X509 Certificate", "Choose a certificate to examine.",
 X509SelectionFlag.SingleSelection);
        X509Certificate2 certificate = collection[0];
        X509Certificate2UI.DisplayCertificate(certificate);
        //Output chain information of the selected certificate.
        X509Chain ch = new X509Chain();
        ch.Build (certificate);
        Console.WriteLine ("Chain Information");
        ch.ChainPolicy.RevocationMode = X509RevocationMode.Online;
        Console.WriteLine ("Chain revocation flag: {0}", ch.ChainPolicy.RevocationFlag);
        Console.WriteLine ("Chain revocation mode: {0}", ch.ChainPolicy.RevocationMode);
        Console.WriteLine ("Chain verification flag: {0}", ch.ChainPolicy.VerificationFlags);
        Console.WriteLine ("Chain verification time: {0}", ch.ChainPolicy.VerificationTime);
        Console.WriteLine ("Chain status length: {0}", ch.ChainStatus.Length);
        Console.WriteLine ("Chain application policy count: {0}", ch.ChainPolicy.ApplicationPolicy.Count);
        Console.WriteLine ("Chain certificate policy count: {0} {1}", ch.ChainPolicy.CertificatePolicy.Count,
 Environment.NewLine);
        //Output chain element information.
        Console.WriteLine ("Chain Element Information");
        Console.WriteLine ("Number of chain elements: {0}", ch.ChainElements.Count);
        Console.WriteLine ("Chain elements synchronized? {0} {1}", ch.ChainElements.IsSynchronized,
 Environment.NewLine);
    
        foreach (X509ChainElement element in
 ch.ChainElements)
        {
            Console.WriteLine ("Element issuer name: {0}", element.Certificate.Issuer);
            Console.WriteLine ("Element certificate valid until: {0}",
 element.Certificate.NotAfter);
            Console.WriteLine ("Element certificate is valid: {0}", element.Certificate.Verify
 ());
            Console.WriteLine ("Element error status length: {0}", element.ChainElementStatus.Length);
            Console.WriteLine ("Element information: {0}", element.Information);
            Console.WriteLine ("Number of element extensions: {0}{1}",
 element.Certificate.Extensions.Count, Environment.NewLine);

            if (ch.ChainStatus.Length > 1)
            {
                for (int index = 0; index <
 element.ChainElementStatus.Length; index++)
                {
                    Console.WriteLine (element.ChainElementStatus[index].Status);
                    Console.WriteLine (element.ChainElementStatus[index].StatusInformation);
                }
            }
        }
        store.Close();
    }
}

継承階層

System.Object
  System.Security.Cryptography.X509Certificates.X509Chain

スレッド セーフ

この型の 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

参照

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

X509Chain コンストラクタ ()

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

X509Chain クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New X509Chain

C#

public X509Chain ()

C++

public:
X509Chain ()

J#

public X509Chain ()

JScript

public function X509Chain ()

使用例

現在のユーザーの個人用証明書ストアを開いて、証明書を選択できるようにし、証明書および証明書チェーン情報をコンソールに出力するコード例を次に示します。出力は、選択した証明書に依存します。

C#

//Output chain information of the selected certificate.
X509Chain ch = new X509Chain();
ch.Build (certificate);
Console.WriteLine ("Chain Information");
ch.ChainPolicy.RevocationMode = X509RevocationMode.Online;
Console.WriteLine ("Chain revocation flag: {0}", ch.ChainPolicy.RevocationFlag);
Console.WriteLine ("Chain revocation mode: {0}", ch.ChainPolicy.RevocationMode);
Console.WriteLine ("Chain verification flag: {0}", ch.ChainPolicy.VerificationFlags);
Console.WriteLine ("Chain verification time: {0}", ch.ChainPolicy.VerificationTime);
Console.WriteLine ("Chain status length: {0}", ch.ChainStatus.Length);
Console.WriteLine ("Chain application policy count: {0}", ch.ChainPolicy.ApplicationPolicy.Count);
Console.WriteLine ("Chain certificate policy count: {0} {1}", ch.ChainPolicy.CertificatePolicy.Count,
 Environment.NewLine);

プラットフォーム

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

参照

関連項目
X509Chain クラス
X509Chain メンバ
System.Security.Cryptography.X509Certificates 名前空間

X509Chain コンストラクタ (Boolean)

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

コンピュータのコンテキストを使用するかどうかを示す値を指定して、X509Chain クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    useMachineContext As Boolean _
)

Visual Basic (使用法)

Dim useMachineContext As Boolean

Dim instance As New X509Chain(useMachineContext)

C#

public X509Chain (
    bool useMachineContext
)

C++

public:
X509Chain (
    bool useMachineContext
)

J#

public X509Chain (
    boolean useMachineContext
)

JScript

public function X509Chain (
    useMachineContext : boolean
)

パラメータ

useMachineContext

コンピュータのコンテキストを使用する場合は true。現在のユーザーのコンテキストを使用する場合は false。

解説

このコンストラクタは、ユーザー プロファイルが読み込まれず、コンピュータのコンテキストを使用する必要がある場合に使用できます。useMachineContext パラメータを true に設定すると、チェーンの作成にローカル コンピュータのコンテキスト (HCCE_LOCAL_MACHINE フラグ) が使用されます。このパラメータを false に設定すると、現在のユーザーのコンテキスト (HCCE_CURRENT_USER フラグ) が使用されます。

使用例

現在のユーザーの個人用証明書ストアを開いて、証明書を選択できるようにし、証明書および証明書チェーン情報をコンソールに出力するコード例を次に示します。出力は、選択した証明書に依存します。

C#

//Output chain information of the selected certificate.
X509Chain ch = new X509Chain();
ch.Build (certificate);
Console.WriteLine ("Chain Information");
ch.ChainPolicy.RevocationMode = X509RevocationMode.Online;
Console.WriteLine ("Chain revocation flag: {0}", ch.ChainPolicy.RevocationFlag);
Console.WriteLine ("Chain revocation mode: {0}", ch.ChainPolicy.RevocationMode);
Console.WriteLine ("Chain verification flag: {0}", ch.ChainPolicy.VerificationFlags);
Console.WriteLine ("Chain verification time: {0}", ch.ChainPolicy.VerificationTime);
Console.WriteLine ("Chain status length: {0}", ch.ChainStatus.Length);
Console.WriteLine ("Chain application policy count: {0}", ch.ChainPolicy.ApplicationPolicy.Count);
Console.WriteLine ("Chain certificate policy count: {0} {1}", ch.ChainPolicy.CertificatePolicy.Count,
 Environment.NewLine);

プラットフォーム

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

参照

関連項目
X509Chain クラス
X509Chain メンバ
System.Security.Cryptography.X509Certificates 名前空間

X509Chain コンストラクタ (IntPtr)

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

X.509 チェーンを識別する IntPtr ハンドルを使用して X509Chain クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    chainContext As IntPtr _
)

Visual Basic (使用法)

Dim chainContext As IntPtr

Dim instance As New X509Chain(chainContext)

C#

public X509Chain (
    IntPtr chainContext
)

C++

public:
X509Chain (
    IntPtr chainContext
)

J#

public X509Chain (
    IntPtr chainContext
)

JScript

public function X509Chain (
    chainContext : IntPtr
)

パラメータ

chainContext

X.509 チェーンを識別する IntPtr ハンドル。

例外

例外の種類	条件
ArgumentNullException	chainContext パラメータが null 参照 (Visual Basic では Nothing) です。
CryptographicException	chainContext パラメータが無効なコンテキストを指しています。

解説

このコンストラクタを使用して、アンマネージ CAPI (Microsoft Cryptographic API) との互換性を提供します。

.NET Framework のセキュリティ

• SecurityPermissionAttribute  (アンマネージ コードを使用するために必要なアクセス許可)。LinkDemand (セキュリティ アクション)。UnmanagedCode (関連する列挙体)
• SecurityPermissionAttribute  (アンマネージ コードを使用するために必要なアクセス許可)。InheritanceDemand (セキュリティ アクション)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

関連項目
X509Chain クラス
X509Chain メンバ
System.Security.Cryptography.X509Certificates 名前空間

X509Chain コンストラクタ

X509Chain クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
X509Chain ()	X509Chain クラスの新しいインスタンスを初期化します。
X509Chain (Boolean)	コンピュータのコンテキストを使用するかどうかを示す値を指定して、X509Chain クラスの新しいインスタンスを初期化します。
X509Chain (IntPtr)	X.509 チェーンを識別する IntPtr ハンドルを使用して X509Chain クラスの新しいインスタンスを初期化します。

参照

関連項目

X509Chain クラス
X509Chain メンバ
System.Security.Cryptography.X509Certificates 名前空間

X509Chain プロパティ

パブリック プロパティ

	名前	説明
	ChainContext	X.509 チェーンを識別するハンドルを取得します。
	ChainElements	X509ChainElement オブジェクトのコレクションを取得します。
	ChainPolicy	X.509 証明書チェーンを作成するときに使用する X509ChainPolicy を取得または設定します。
	ChainStatus	X509Chain オブジェクト内の各要素の状態を取得します。

参照

関連項目

X509Chain クラス
System.Security.Cryptography.X509Certificates 名前空間

X509Chain メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Build	X509ChainPolicy で指定したポリシーを使用して X.509 チェーンを作成します。
	Create	CryptoConfig ファイルで定義されたマップを照会した後で X509Chain オブジェクトを作成し、チェーンをそのマップに割り当てます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Reset	現在の X509Chain オブジェクトを消去します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

X509Chain クラス
System.Security.Cryptography.X509Certificates 名前空間

X509Chain メンバ

X509Certificate2 証明書のチェーン作成エンジンを表します。

X509Chain データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	X509Chain	オーバーロードされます。 X509Chain クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ChainContext	X.509 チェーンを識別するハンドルを取得します。
	ChainElements	X509ChainElement オブジェクトのコレクションを取得します。
	ChainPolicy	X.509 証明書チェーンを作成するときに使用する X509ChainPolicy を取得または設定します。
	ChainStatus	X509Chain オブジェクト内の各要素の状態を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Build	X509ChainPolicy で指定したポリシーを使用して X.509 チェーンを作成します。
	Create	CryptoConfig ファイルで定義されたマップを照会した後で X509Chain オブジェクトを作成し、チェーンをそのマップに割り当てます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Reset	現在の X509Chain オブジェクトを消去します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

X509Chain クラス
System.Security.Cryptography.X509Certificates 名前空間