WebRequest.Credentials WebRequest.Credentials WebRequest.Credentials WebRequest.Credentials Property

定義

派生クラスでオーバーライドされると、インターネット リソースを使用して要求を認証するために使用されるネットワーク資格情報を取得または設定します。When overridden in a descendant class, gets or sets the network credentials used for authenticating the request with the Internet resource.

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

プロパティ値

要求に関連付けられた認証資格情報を格納する ICredentialsAn ICredentials containing the authentication credentials associated with the request. 既定値は、null です。The default is null.

例外

プロパティが派生クラスでオーバーライドされていないのに、そのプロパティの取得または設定が試行されました。Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

次の例ではCredentials 、現在のユーザーの既定の資格情報を使用してプロパティを設定します。The following example sets the Credentials property using the default credentials of the current user. 要求が行われると、このプロパティに格納されている資格情報がクライアントの検証に使用されます。When the request is made, credentials stored in this property are used to validate the client. これは、 UseDefaultCredentialsプロパティをにtrue設定することと同じです。This is identical to setting the UseDefaultCredentials property to 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)

注釈

プロパティCredentialsは、インターネットリソースにアクセスするために必要な認証資格情報を格納します。The Credentials property contains the authentication credentials required to access the Internet resource.

注意

WebRequest クラスabstractはクラスです。The WebRequest class is an abstract class. 実行時のインスタンスWebRequestの実際の動作は、 WebRequest.Createメソッドによって返される派生クラスによって決まります。The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. 既定値と例外の詳細については、「」 HttpWebRequestFileWebRequest「」など、子孫クラスのドキュメントを参照してください。For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

適用対象

こちらもご覧ください