HttpWebRequest.PreAuthenticate プロパティ

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

プロパティ値

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

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

適用対象