HttpWebRequest.PreAuthenticate プロパティ

.NET Framework クラス ライブラリ リファレンス

HttpWebRequest.PreAuthenticate プロパティ

要求で認証ヘッダーを送信するかどうかを示す値を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 PreAuthenticate As Boolean

Visual Basic (使用法)

Dim instance As HttpWebRequest
Dim value As Boolean

value = instance.PreAuthenticate

instance.PreAuthenticate = value

C#

public override bool PreAuthenticate { get;
 set; }

C++

public:
virtual property bool PreAuthenticate {
    bool get () override;
    void set (bool value)
 override;
}

J#

/** @property */
public boolean get_PreAuthenticate ()

/** @property */
public void set_PreAuthenticate (boolean value)

JScript

public override function get
 PreAuthenticate () : boolean

public override function set
 PreAuthenticate (value : boolean)

プロパティ値
認証が行われた後に、要求で WWW-authenticate HTTP ヘッダーを送信する場合は true。それ以外の場合は false。既定値は false です。

解説

特定の Uri に対するクライアント要求が正常に認証された場合、PreAuthenticate が true で、かつ資格情報が提供されていれば、その Uri への要求のたびに WWW-authenticate ヘッダーが送信されます。それ以外の場合、要求には標準の認証プロシージャが使用されます。

最初の要求を除き、PreAuthenticate プロパティは、サーバーがチャレンジするまで待機せずに、2 回目以降に行われる特定の Uri に対する要求で、認証情報を送信するかどうかを指定します。

次に示すクライアントとサーバー間のやり取りは、このプロパティを使用した場合の結果を示したものです。ダイアログ ボックスでは基本認証が使用されているとします。

PreAuthenticate が false です。

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET with Authorization headers

Server: 200 OK

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET with Authorization headers

Server: 200 OK

PreAuthenticate が true です。

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET with Authorization headers

Server: 200 OK

Client: GET someUrl with Authorization headers

認証方式が事前認証をサポートしていない場合、このプロパティの値は無視されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
HttpWebRequest クラス
HttpWebRequest メンバ
System.Net 名前空間