HttpWebRequest.PreAuthenticate プロパティ

定義

名前空間:

System.Net

アセンブリ:

System.Net.Requests.dll

ソース:

HttpWebRequest.cs

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

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

public override bool PreAuthenticate { get; set; }

member this.PreAuthenticate : bool with get, set

Public Overrides Property PreAuthenticate As Boolean

プロパティ値

Boolean

true 認証が行われた後に要求を含む HTTP 承認ヘッダーを送信する場合。それ以外の場合は false。 既定値は、false です。

注釈

特定Uriの に対するクライアント要求が正常に認証された後、 が true で資格情報が指定されている場合PreAuthenticate、Authorization ヘッダーは各要求と共に、最後のスラッシュまでの特定Uriのに一致するにUri送信されます。 そのため、クライアント要求が次を含む特定 Uri の要求に対して正常に認証された場合は、次のようになります。

http://www.contoso.com/firstpath/

その後、事前認証の Authorization ヘッダーが、各要求と共に次 Uri のいずれかのインスタンスに送信されます。

http://www.contoso.com/firstpath/

http://www.contoso.com/firstpath/default

http://www.contoso.com/firstpath/default.html

http://www.contoso.com/firstpath/sample.html

ただし、Authorization ヘッダーは、次 Uri のいずれかのインスタンスに要求と共に送信されません。

http://www.contoso.com/

http://www.contoso.com/firstpath

http://www.contoso.com/secondpath/

http://www.contoso.com/firstpath/thirdpath/

特定 Uri のクライアント要求が正常に認証されない場合、要求では標準の認証手順が使用されます。

最初の要求を除き、 プロパティは、 PreAuthenticate サーバーによるチャレンジを待たずに Uri 、最後のスラッシュまでの特定 Uri に一致する に後続の要求を含む認証情報を送信するかどうかを示します。

クライアントとサーバーの間の次のダイアログは、このプロパティの効果を示しています。 このダイアログでは、基本認証が使用されていることを前提としています。

PreAuthenticate は falseです。

クライアント: GET someUrl

サーバー: 401 WWW-Authenticate Basic

クライアント: 承認ヘッダーを含む GET

サーバー: 200 OK

クライアント: GET someUrl

サーバー: 401 WWW-Authenticate Basic

クライアント: 承認ヘッダーを含む GET

サーバー: 200 OK

PreAuthenticate は trueです。

クライアント: GET someUrl

サーバー: 401 WWW-Authenticate Basic

クライアント: 承認ヘッダーを含む GET

サーバー: 200 OK

クライアント: 承認ヘッダーを含む get someUrl

認証スキームで事前認証がサポートされていない場合、このプロパティの値は無視されます。