HttpWebClientProtocol.ClientCertificates プロパティ

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

HttpWebClientProtocol.ClientCertificates プロパティ

クライアント証明書のコレクションを取得します。

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 ClientCertificates As X509CertificateCollection

Visual Basic (使用法)

Dim instance As HttpWebClientProtocol
Dim value As X509CertificateCollection

value = instance.ClientCertificates

C#

public X509CertificateCollection ClientCertificates { get;
 }

C++

public:
property X509CertificateCollection^ ClientCertificates {
    X509CertificateCollection^ get ();
}

J#

/** @property */
public X509CertificateCollection get_ClientCertificates ()

JScript

public function get ClientCertificates
 () : X509CertificateCollection

プロパティ値
クライアント証明書を表す X509CertificateCollection。

解説

このプロパティにより、クライアントは XML Web サービス メソッドを呼び出したときに Authenticode X.509 v.3 証明書とも呼ばれる 1 つ以上のクライアント証明書を渡すことができます。XML Web サービス メソッドでクライアント証明書を使用するように設定されている場合は、クライアント証明書をクライアント認証の方法の 1 つとして使用できます。クライアント証明書の設定の詳細については、Internet Information Services (IIS) のドキュメントを参照してください。

使用例

ファイルからクライアント証明書を読み込んで ClientCertificates プロパティに追加し、認証にクライアント証明書を使用する XML Web サービス メソッドを呼び出すコード例を次に示します。

Visual Basic

' Create a new instance of a proxy class for the Bank XML Web service.
Dim bank As BankSession = new
 BankSession()

' Load the client certificate from a file.
Dim x509 As X509Certificate = X509Certificate.CreateFromCertFile("c:\user.cer")

' Add the client certificate to the ClientCertificates property of the
 proxy class.
bank.ClientCertificates.Add(x509)

' Communicate with the Deposit XML Web service method,
' which requires authentication using client certificates.
bank.Deposit(500)

C#

// Create a new instance of a proxy class for the Bank XML Web service.
BankSession bank = new BankSession();

// Load the client certificate from a file.
X509Certificate x509 = X509Certificate.CreateFromCertFile(@"c:\user.cer");

// Add the client certificate to the ClientCertificates property of
 the proxy class.
bank.ClientCertificates.Add(x509);

// Communicate with the Deposit XML Web service method,
// which requires authentication using client certificates.
bank.Deposit(500);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0

参照

関連項目
HttpWebClientProtocol クラス
HttpWebClientProtocol メンバ
System.Web.Services.Protocols 名前空間
X509CertificateCollection
その他の技術情報
ASP.NET を使用して作成した XML Web サービスのセキュリティ