HttpWebRequest.PreAuthenticate プロパティ
要求で認証ヘッダーを送信するかどうかを示す値を取得または設定します。
Overrides Public Property PreAuthenticate As Boolean
[C#]
public override bool PreAuthenticate {get; set;}
[C++]
public: __property bool get_PreAuthenticate();public: __property void set_PreAuthenticate(bool);
[JScript]
public override function get PreAuthenticate() : Boolean;public override function set PreAuthenticate(Boolean);
プロパティ値
初期要求で WWW-authenticate HTTP ヘッダーを送信する場合は true 。それ以外の場合は false 。既定値は false です。
解説
クライアント要求が正常に認証された場合、 PreAuthenticate が true で、かつ資格情報が提供されていれば、各要求の際には WWW-authenticate ヘッダーが送信されます。それ以外の場合、要求には標準の認証プロシージャが使用されます。
次に示すクライアントとサーバー間のやり取りは、このプロパティを使用した場合の結果を示したものです。
事前認証が langword="false"/> である場合
Client: GET someUrl
Server: 401 WWW-Authenticate Basic
Client: GET with Authorization headers
Server: 200 OK
Client: GET someUrl2
Server: 401 WWW-Authenticate Basic
Client: GET with Authorization headers
Server: 200 OK
事前認証が true である場合
Client: GET someUrl
Server: 401 WWW-Authenticate Basic
Client: GET with Authorization headers
Server: 200 OK
Client: GET someUrl2 with Authorization headers
認証方式が事前認証をサポートしていない場合、このプロパティの値は無視されます。
必要条件
プラットフォーム: 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