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
.
Комментарии
Задайте значение AllowAutoRedirect , true
если нужно, чтобы обработчик автоматически следал за заголовками перенаправления HTTP в новое расположение ресурса. Максимальное количество перенаправлений для выполнения задается свойством MaxAutomaticRedirections .
Если AllowAutoRedirect параметр имеет значение false
, все HTTP-ответы с кодом состояния HTTP от 300 до 399 возвращаются в приложение.
Заголовок Authorization очищается при автоматическом перенаправлении, и обработчик автоматически пытается повторно пройти проверку подлинности в перенаправленном расположении. Другие заголовки не очищаются. На практике это означает, что приложение не может поместить сведения о пользовательской проверке подлинности в заголовок авторизации, если можно столкнуться с перенаправлением. Вместо этого приложение должно реализовать и зарегистрировать пользовательский модуль проверки подлинности.
Если вы используете файлы cookie, специально добавляя их в Headers коллекцию, они не удаляются при перенаправлении, так как обработчик не может узнать, для какого домена разрешен файл cookie. Если вы хотите имитировать поведение браузера, используйте CookieContainer класс , который позволяет указать целевой домен для файла cookie.
Примечание
Если AllowAutoRedirect задано значение true
, платформа .NET Framework будет следовать перенаправлениям даже при перенаправлении на URI HTTP из URI HTTPS.
.NET Core версий 1.0, 1.1 и 2.0 не будет следовать перенаправлению с HTTPS на HTTP, даже если AllowAutoRedirect для задано значение true
.