SocketsHttpHandler.AllowAutoRedirect プロパティ

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

ソース:

SocketsHttpHandler.cs

ハンドラーがリダイレクト応答に従うかどうかを示す値を取得または設定します。

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

public bool AllowAutoRedirect { get; set; }

member this.AllowAutoRedirect : bool with get, set

Public Property AllowAutoRedirect As Boolean

プロパティ値

Boolean

true ハンドラーがリダイレクト応答に従う必要がある場合は 。それ以外の場合 falseは 。 既定値は true です。

注釈

trueハンドラーが HTTP リダイレクト ヘッダーを自動的にリソースの新しい場所に従う場合は、 を に設定AllowAutoRedirectします。 後続するリダイレクトの最大数は、 プロパティによって設定されます MaxAutomaticRedirections 。

が にfalse設定されている場合AllowAutoRedirect、HTTP 状態コードが 300 から 399 のすべての HTTP 応答がアプリケーションに返されます。

自動リダイレクトでは Authorization ヘッダーがクリアされ、ハンドラーは自動的にリダイレクトされた場所への再認証を試みます。 他のヘッダーはクリアされません。 実際には、リダイレクトが発生する可能性がある場合、アプリケーションはカスタム認証情報を Authorization ヘッダーに配置できないことを意味します。 代わりに、アプリケーションでカスタム認証モジュールを実装して登録する必要があります。

Cookie を特にコレクションに Headers 追加して使用している場合、リダイレクトの後に Cookie が許可されているドメインをハンドラーが知る方法がないため、これらはクリアされません。 ブラウザーの動作を模倣する場合は、 クラスを CookieContainer 使用して、Cookie のターゲット ドメインを指定できます。

注意

が に設定されている場合 AllowAutoRedirect でも、ハンドラーは HTTPS から HTTP へのリダイレクトに true従うことはありません。