HttpWebRequest.AllowAutoRedirect 屬性

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

HttpWebRequest.cs

取得或設定值，指出要求是否應該遵循重新導向回應。

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

public virtual bool AllowAutoRedirect { get; set; }

member this.AllowAutoRedirect : bool with get, set

Public Overridable Property AllowAutoRedirect As Boolean

屬性值

Boolean

true 要求是否應該自動遵循來自因特網資源的重新導向回應;否則，false。 預設值為 true。

範例

下列程式代碼範例會使用 AllowAutoRedirect 屬性來允許要求遵循重新導向回應。

// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->MaximumAutomaticRedirections = 1;
myHttpWebRequest->AllowAutoRedirect = true;
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );

// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");	
myHttpWebRequest.MaximumAutomaticRedirections=1;
myHttpWebRequest.AllowAutoRedirect=true;
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();

     'This method creates a new HttpWebRequest Object to the mentioned URL.
         Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
         myHttpWebRequest.MaximumAutomaticRedirections = 1
         myHttpWebRequest.AllowAutoRedirect = True
         Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

如果您希望要求自動遵循 HTTP 重新導向標頭至資源的新位置，請將 AllowAutoRedirect 設定為 true。 要遵循的重新導向數目上限是由 MaximumAutomaticRedirections 屬性所設定。

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

[授權] 標頭會在自動重新導向時清除，HttpWebRequest 會自動嘗試重新驗證至重新導向的位置。 實際上，這表示如果可能遇到重新導向，應用程式就無法將自定義驗證資訊放入 Authorization 標頭中。 相反地，應用程式必須實作並註冊自定義驗證模組。 System.Net.AuthenticationManager 和相關類別可用來實作自定義驗證模組。 AuthenticationManager.Register 方法會註冊自定義驗證模組。