WebRequest.PreAuthenticate プロパティ
派生クラスでオーバーライドされると、要求の事前認証を行うかどうかを指定します。
Public Overridable Property PreAuthenticate As Boolean
[C#]
public virtual bool PreAuthenticate {get; set;}
[C++]
public: __property virtual bool get_PreAuthenticate();public: __property virtual void set_PreAuthenticate(bool);
[JScript]
public function get PreAuthenticate() : Boolean;public function set PreAuthenticate(Boolean);
プロパティ値
事前認証を行う場合は true 。それ以外の場合は false 。
例外
例外の種類 | 条件 |
---|---|
NotSupportedException | プロパティが派生クラスでオーバーライドされていないのに、そのプロパティの取得または設定が試行されました。 |
解説
PreAuthenticate プロパティは、初期要求で認証情報を送信するかどうかを指定します。 PreAuthenticate が false の場合、 WebRequest は、認証情報を送信する前に、認証チャレンジを待機します。
メモ WebRequest クラスは、抽象 (Visual Basic では MustInherit) クラスです。実行時の WebRequest インスタンスの実際の動作は、 WebRequest.Create メソッドで返される派生クラスによって決まります。既定値および例外の詳細については、 HttpWebRequest や FileWebRequest などの派生クラスの説明を参照してください。
使用例
[Visual Basic, C#, C++] PreAuthenticate プロパティを true に設定して、 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 名前空間 | HttpWebRequest.PreAuthenticate