HttpClientHandler.AllowAutoRedirect 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,這個值指出此處理常式是否應該接在重新導向回應之後。
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
為 。