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.

Задайте для AllowAutoRedirect значение true, если вы хотите, чтобы запрос автоматически следовать заголовкам перенаправления HTTP в новое расположение ресурса. Максимальное количество последующих перенаправлений устанавливается свойством MaximumAutomaticRedirections.

Если для AllowAutoRedirect задано значение false, все ответы с кодом состояния HTTP от 300 до 399 возвращаются приложению.

Заголовок авторизации очищается при автоматическом перенаправлении и HttpWebRequest автоматически пытается повторно пройти проверку подлинности в перенаправленном расположении. На практике это означает, что приложение не может поместить пользовательские сведения проверки подлинности в заголовок авторизации, если это возможно для перенаправления. Вместо этого приложение должно реализовать и зарегистрировать пользовательский модуль проверки подлинности. Для реализации пользовательского модуля проверки подлинности используется System.Net.AuthenticationManager и связанный класс. Метод AuthenticationManager.Register регистрирует настраиваемый модуль проверки подлинности.