Поделиться через


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.

Комментарии

Установите значение AllowAutoRedirecttrue , если обработчик будет автоматически следовать заголовкам перенаправления HTTP в новое расположение ресурса. Максимальное количество перенаправлений, которые необходимо выполнить, задается свойством MaxAutomaticRedirections .

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

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

Если вы используете файлы cookie, добавляя их в Headers коллекцию, они не очищаются при выполнении перенаправления, так как обработчик не может знать, какой домен разрешен для файла cookie. Если вы хотите имитировать поведение браузера, используйте CookieContainer класс, позволяющий указать целевой домен для файла cookie.

Замечание

В .NET Core и .NET 5 и более поздних версиях параметр AllowAutoRedirect не trueвключает автоматическое перенаправление в URI HTTP из URI HTTPS. Такие (безопасные для небезопасной) перенаправления выполняются только в .NET Framework.

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