WebClient.Credentials プロパティ

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

WebClient.Credentials プロパティ

ホストに送信し、要求の認証に使用するネットワーク資格情報を取得または設定します。

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

Visual Basic (宣言)

Public Property Credentials As
 ICredentials

Visual Basic (使用法)

Dim instance As WebClient
Dim value As ICredentials

value = instance.Credentials

instance.Credentials = value

C#

public ICredentials Credentials { get; set;
 }

C++

public:
property ICredentials^ Credentials {
    ICredentials^ get ();
    void set (ICredentials^ value);
}

J#

/** @property */
public ICredentials get_Credentials ()

/** @property */
public void set_Credentials (ICredentials value)

JScript

public function get Credentials
 () : ICredentials

public function set Credentials
 (value : ICredentials)

プロパティ値
要求の認証資格情報を格納している ICredentials。既定値は null 参照 (Visual Basic では Nothing) です。

解説

Credentials プロパティは、ホスト上のリソースへのアクセスに使用する認証資格情報を格納します。クライアント側のほとんどのシナリオでは、現在ログオンしているユーザーの資格情報である DefaultCredentials を使用する必要があります。これを使用するには、このプロパティを設定する代わりに、UseDefaultCredentials プロパティに true を設定します。

WebClient クラスを ASP.NET アプリケーションなどの中間層アプリケーションで使用する場合、DefaultCredentials は ASP ページを実行しているアカウントに属します (サーバー側の資格情報)。通常、このプロパティには、要求が行われた対象クライアントの資格情報を設定します。

使用例

ユーザーのシステム資格情報を使用して、要求を認証するコード例を次に示します。

プラットフォーム

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、1.1、1.0

参照

関連項目
WebClient クラス
WebClient メンバ
System.Net 名前空間
NetworkCredential クラス
CredentialCache クラス
WebRequest.Credentials