HttpClientHandler.AllowAutoRedirect 屬性

定義

取得或設定值,這個值指出此處理常式是否應該接在重新導向回應之後。

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

屬性值

true 如果處理程式應遵循重新導向回應,則為 ;否則為 false。 預設值是 true

備註

true如果您要讓處理程式自動遵循 HTTP 重新導向標頭至資源的新位置,請將 設定AllowAutoRedirect為 。 要遵循的重新導向數目上限是由 屬性所 MaxAutomaticRedirections 設定。

如果 AllowAutoRedirect 設定為 false,則所有 HTTP 狀態代碼從 300 到 399 的 HTTP 回應都會傳回至應用程式。

[授權] 標頭會在自動重新導向時清除,而處理程式會自動嘗試重新驗證至重新導向的位置。 不會清除其他標頭。 實際上,這表示如果可能遇到重新導向,應用程式就無法將自定義驗證資訊放入授權標頭中。 相反地,應用程式必須實作並註冊自定義驗證模組。

如果您藉由特別將它們新增至 Headers 集合來使用 Cookie,則追蹤重新導向時不會清除這些 Cookie,因為處理程式無法得知 Cookie 允許的網域。 如果您想要模擬瀏覽器行為,請使用 CookieContainer 類別,讓您指定 Cookie 的目標網域。

注意

AllowAutoRedirect 設為 true時,即使從 HTTPS URI 重新導向至 HTTP URI,.NET Framework 仍會遵循重新導向。 .NET Core 1.0、1.1 和 2.0 版不會遵循從 HTTPS 重新導向至 HTTP,即使 AllowAutoRedirect 設定 true為 。

適用於