WebRequest.Credentials プロパティ

定義

名前空間:

System.Net

アセンブリ:

System.Net.Requests.dll

ソース:

WebRequest.cs

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

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

public virtual System.Net.ICredentials? Credentials { get; set; }

member this.Credentials : System.Net.ICredentials with get, set

Public Overridable Property Credentials As ICredentials

プロパティ値

ICredentials

要求に関連付けられている認証資格情報を含む ICredentials。 既定値は nullです。

例外

NotImplementedException

子孫クラスでプロパティがオーバーライドされていない場合は、プロパティの取得または設定が試行されます。

例

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

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

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

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。 代わりに HttpClient を使用してください。

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

手記

WebRequest クラスは、abstract クラスです。 実行時の WebRequest インスタンスの実際の動作は、WebRequest.Create メソッドによって返される子孫クラスによって決まります。 既定値と例外の詳細については、HttpWebRequest や FileWebRequestなどの子孫クラスのドキュメントを参照してください。

こちらもご覧ください

• NetworkCredential
• CredentialCache
• Credentials