HttpWebRequest.AllowAutoRedirect Свойство

Определение

Возвращает или задает значение, которое указывает, должен ли запрос следовать ответам переадресации.Gets or sets a value that indicates whether the request should follow redirection responses.

public:
 virtual property bool AllowAutoRedirect { bool get(); void set(bool value); };
public:
 property bool AllowAutoRedirect { bool get(); void set(bool value); };
public virtual bool AllowAutoRedirect { get; set; }
public bool AllowAutoRedirect { get; set; }
member this.AllowAutoRedirect : bool with get, set
Public Overridable Property AllowAutoRedirect As Boolean
Public Property AllowAutoRedirect As Boolean

Значение свойства

Boolean

Значение true, если запрос должен автоматически следовать ответам переадресации, получаемым от интернет-ресурса; в противном случае — значение false.true if the request should automatically follow redirection responses from the Internet resource; otherwise, false. Значение по умолчанию — true.The default value is true.

Примеры

В следующем примере кода свойство используется, AllowAutoRedirect чтобы позволить запросу следовать ответам перенаправления.The following code example uses the AllowAutoRedirect property to allow the request to follow redirection responses.

// 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)

Комментарии

Задайте значение, если необходимо, чтобы AllowAutoRedirect true запрос автоматически подследовал заголовки перенаправления HTTP к новому расположению ресурса.Set AllowAutoRedirect to true if you want the request to automatically follow HTTP redirection headers to the new location of the resource. Максимальное количество перенаправлений, которое следует отслеживать, задается MaximumAutomaticRedirections свойством.The maximum number of redirections to follow is set by the MaximumAutomaticRedirections property.

Если параметр AllowAutoRedirect имеет значение false , то в приложение возвращается все ответы с кодом состояния HTTP из 300 в 399.If AllowAutoRedirect is set to false, all responses with an HTTP status code from 300 to 399 is returned to the application.

Заголовок авторизации удаляется при автоматическом перенаправлении и HttpWebRequest автоматически пытается повторно пройти проверку подлинности в перенаправленном расположении.The Authorization header is cleared on auto-redirects and HttpWebRequest automatically tries to re-authenticate to the redirected location. На практике это означает, что приложение не может добавить пользовательские сведения о проверке подлинности в заголовок авторизации, если возможно возникнет перенаправление.In practice, this means that an application can't put custom authentication information into the Authorization header if it is possible to encounter redirection. Вместо этого приложение должно реализовать и зарегистрировать настраиваемый модуль проверки подлинности.Instead, the application must implement and register a custom authentication module. System.Net.AuthenticationManagerСвязанный класс и используется для реализации пользовательского модуля проверки подлинности.The System.Net.AuthenticationManager and related class are used to implement a custom authentication module. AuthenticationManager.RegisterМетод регистрирует пользовательский модуль проверки подлинности.The AuthenticationManager.Register method registers a custom authentication module.

Применяется к