WebRequest.Credentials プロパティ

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

WebRequest.Credentials プロパティ

派生クラスでオーバーライドされると、インターネット リソースの要求を認証するために使用するネットワーク資格情報を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 Credentials As ICredentials

Visual Basic (使用法)

Dim instance As WebRequest
Dim value As ICredentials

value = instance.Credentials

instance.Credentials = value

C#

public virtual ICredentials Credentials { get;
 set; }

C++

public:
virtual 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) です。

例外

例外の種類	条件
NotImplementedException	プロパティが派生クラスでオーバーライドされていないのに、そのプロパティの取得または設定が試行されました。

解説

Credentials プロパティは、インターネット リソースにアクセスするために必要な認証資格情報を格納します。

メモ
WebRequest クラスは、abstract クラスです。実行時の WebRequest インスタンスの実際の動作は、System.Net.WebRequest.Create メソッドで返される派生クラスによって決まります。既定値および例外の詳細については、HttpWebRequest や FileWebRequest などの派生クラスの説明を参照してください。

使用例

現在のユーザーの既定の資格情報を使用して、Credentials プロパティを設定する例を次に示します。要求が行われると、クライアントは、このプロパティに格納されている資格情報を使用して検証されます。これは、UseDefaultCredentials プロパティを true に設定することと同じです。

Visual Basic

' Create a request for the URL.         
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(),
 HttpWebResponse)

C#

// Create a request for the URL.         
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();

C++

// Create a request for the URL.   
WebRequest^ request = WebRequest::Create( "http://www.contoso.com/default.html"
 );

// If required by the server, set the credentials.
request->Credentials = CredentialCache::DefaultCredentials;

// Get the response.
HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebRequest クラス
WebRequest メンバ
System.Net 名前空間
NetworkCredential クラス
CredentialCache クラス
HttpWebRequest.Credentials プロパティ