X509Chain.Build メソッド

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

X509Chain.Build メソッド

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

X509ChainPolicy で指定したポリシーを使用して X.509 チェーンを作成します。

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

Visual Basic (宣言)

Public Function Build ( _
    certificate As X509Certificate2 _
) As Boolean

Visual Basic (使用法)

Dim instance As X509Chain
Dim certificate As X509Certificate2
Dim returnValue As Boolean

returnValue = instance.Build(certificate)

C#

public bool Build (
    X509Certificate2 certificate
)

C++

public:
bool Build (
    X509Certificate2^ certificate
)

J#

public boolean Build (
    X509Certificate2 certificate
)

JScript

public function Build (
    certificate : X509Certificate2
) : boolean

パラメータ

certificate

X509Certificate2 オブジェクト。

戻り値
X.509 証明書が有効な場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentException	certificate が有効な証明書でないか、または値が null 参照 (Visual Basic では Nothing) です。
CryptographicException	certificate を読み取ることができません。

解説

信頼される発行者の有効な X.509 証明書は、X509ChainPolicy オブジェクトで指定する使用方法だけについて有効です。これらのチェーン ポリシー規則に一致する証明書でも、SMIME (Security/MIME)、Authenticode、SSL (Secure Sockets Layer) などの機能を使用する特定の使用方法については無効である場合があります。特定のポリシーについて証明書が有効かどうかを判断するためにさらに処理が必要な場合は、X509Chain からクラスを派生させ、Build メソッドをオーバーライドします。この操作によって、基本クラスの Build メソッドを先に呼び出してから追加の処理を実行できます。

使用例

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

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);

.NET Framework のセキュリティ

• StorePermission  (暗号化ストアを開いて列挙するために必要なアクセス許可)。 Demand (セキュリティ アクション)。 OpenStore、EnumerateCertificates (関連する列挙体)

プラットフォーム

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 名前空間