WebRequest.Credentials プロパティ
派生クラスでオーバーライドされると、インターネット リソースの要求を認証するために使用するネットワーク資格情報を取得または設定します。
Public Overridable Property Credentials As ICredentials
[C#]
public virtual ICredentials Credentials {get; set;}
[C++]
public: __property virtual ICredentials* get_Credentials();public: __property virtual void set_Credentials(ICredentials*);
[JScript]
public function get Credentials() : ICredentials;public function set Credentials(ICredentials);
プロパティ値
要求に関連付けられた認証資格情報を格納している ICredentials 。既定値は null 参照 (Visual Basic では Nothing) です。
例外
例外の種類 | 条件 |
---|---|
NotSupportedException | プロパティが派生クラスでオーバーライドされていないのに、そのプロパティの取得または設定が試行されました。 |
解説
Credentials プロパティは、インターネット リソースにアクセスするために必要な認証資格情報を格納します。
メモ WebRequest クラスは、抽象 (Visual Basic では MustInherit) クラスです。実行時の WebRequest インスタンスの実際の動作は、 WebRequest.Create メソッドで返される派生クラスによって決まります。既定値および例外の詳細については、 HttpWebRequest や FileWebRequest などの派生クラスの説明を参照してください。
使用例
[Visual Basic, C#, C++] ユーザーからユーザー名およびパスワードに関する情報を収集し、この情報を使用して NetworkCredential を作成する例を次に示します。Credentials プロパティは、この NetworkCredential で設定されます。要求が行われると、要求側のアクセスは、このプロパティに格納されている資格情報を使用して検証されます。
' Create a new webrequest to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create(url)
' Set 'Preauthenticate' property to true.
myWebRequest.PreAuthenticate = True
Console.WriteLine(ControlChars.Cr + "Please Enter ur credentials for the requested Url")
Console.WriteLine("UserName")
Dim UserName As String = Console.ReadLine()
Console.WriteLine("Password")
Dim Password As String = Console.ReadLine()
' Create a New 'NetworkCredential' object.
Dim networkCredential As New NetworkCredential(UserName, Password)
' Associate the 'NetworkCredential' object with the 'WebRequest' object.
myWebRequest.Credentials = networkCredential
' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
[C#]
// Create a new webrequest to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create(url);
// Set 'Preauthenticate' property to true. Credentials will be sent with the request.
myWebRequest.PreAuthenticate=true;
Console.WriteLine("\nPlease Enter ur credentials for the requested Url");
Console.WriteLine("UserName");
string UserName=Console.ReadLine();
Console.WriteLine("Password");
string Password=Console.ReadLine();
// Create a New 'NetworkCredential' object.
NetworkCredential networkCredential=new NetworkCredential(UserName,Password);
// Associate the 'NetworkCredential' object with the 'WebRequest' object.
myWebRequest.Credentials=networkCredential;
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();
[C++]
// Create a new webrequest to the mentioned URL.
WebRequest* myWebRequest=WebRequest::Create(url);
// Set 'Preauthenticate' property to true. Credentials will be sent with the request.
myWebRequest->PreAuthenticate=true;
Console::WriteLine(S"\nPlease Enter your credentials for the requested Url");
Console::WriteLine(S"UserName");
String* UserName=Console::ReadLine();
Console::WriteLine(S"Password");
String* Password=Console::ReadLine();
// Create a New 'NetworkCredential' object.
NetworkCredential* networkCredential =
new NetworkCredential(UserName, Password);
// Associate the 'NetworkCredential' object with the 'WebRequest' object.
myWebRequest->Credentials=networkCredential;
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse* myWebResponse=myWebRequest->GetResponse();
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
WebRequest クラス | WebRequest メンバ | System.Net 名前空間 | NetworkCredential | CredentialCache | HttpWebRequest.Credentials