X509Chain.Build(X509Certificate2) メソッド

定義

X509ChainPolicyで指定されたポリシーを使用して X.509 チェーンを構築します。

public:
 bool Build(System::Security::Cryptography::X509Certificates::X509Certificate2 ^ certificate);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Build(System.Security.Cryptography.X509Certificates.X509Certificate2 certificate);
public bool Build(System.Security.Cryptography.X509Certificates.X509Certificate2 certificate);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Build : System.Security.Cryptography.X509Certificates.X509Certificate2 -> bool
member this.Build : System.Security.Cryptography.X509Certificates.X509Certificate2 -> bool
Public Function Build (certificate As X509Certificate2) As Boolean

パラメーター

certificate
X509Certificate2

X509Certificate2 オブジェクト。

返品

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

属性

例外

certificateが有効な証明書ではないか、null

certificateは読み取りできません。

次のコード例では、現在のユーザーの個人用証明書ストアを開き、証明書を選択し、証明書と証明書チェーンの情報をコンソールに書き込みます。 出力は、選択した証明書によって異なります。

//Output chain information of the selected certificate.
X509Chain ch = new X509Chain();
ch.ChainPolicy.RevocationMode = X509RevocationMode.Online;
ch.Build (certificate);
Console.WriteLine ("Chain Information");
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 information of the selected certificate.
Dim ch As New X509Chain()
ch.ChainPolicy.RevocationMode = X509RevocationMode.Online
ch.Build(certificate)
Console.WriteLine("Chain Information")
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)

注釈

信頼された発行者からの有効な X.509 証明書は、 X509ChainPolicy オブジェクトで指定された使用に対してのみ有効であることに注意してください。 これらのチェーン ポリシー 規則を満たす証明書は、Security/MIME (SMIME)、Authenticode、Secure Sockets Layer (SSL) などの機能を使用する特定の用途では無効な場合があります。 証明書が特定のポリシーに対して有効かどうかを判断するためにさらに処理が必要な場合は、 X509Chain からクラスを派生させ、 Build メソッドをオーバーライドして、最初に基底クラス Build メソッドを呼び出し、次に追加の処理を実行します。

適用対象