HttpClientHandler.AllowAutoRedirect Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se o manipulador deve seguir respostas de redirecionamento.
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
Valor de Propriedade
true se o manipulador deve seguir respostas de redirecionamento; caso contrário false. O valor predefinido é true.
Observações
Define AllowAutoRedirect para true se quiseres que o handler siga automaticamente os cabeçalhos de redirecionamento HTTP para a nova localização do recurso. O número máximo de redirecionamentos a seguir é definido pela MaxAutomaticRedirections propriedade.
Se AllowAutoRedirect for definido para false, todas as respostas HTTP com código de estado HTTP de 300 a 399 são devolvidas à aplicação.
O cabeçalho Authorization é apagado nos auto-redirecionamentos e o handler tenta automaticamente re-autenticar para a localização redirecionada. Nenhum outro cabeceio é limpo. Na prática, isto significa que uma aplicação não pode colocar informações de autenticação personalizadas no cabeçalho de Autorização se for possível encontrar redirecionamento. Em vez disso, a aplicação deve implementar e registar um módulo de autenticação personalizado.
Se estiver a usar cookies adicionando-os especificamente à Headers coleção, estes não são eliminados quando é seguido um redirecionamento, pois o handler não tem forma de saber para que domínio um cookie é permitido. Se quiseres imitar o comportamento do navegador, usa a CookieContainer classe que te permite especificar o domínio de destino para um cookie.
Note
No .NET Core e .NET versões 5 e posteriores, definir AllowAutoRedirect para truenão permite redirecionar automaticamente para um URI HTTP a partir de um URI HTTPS.
Tais redirecionamentos (seguros a inseguros) só são seguidos no .NET Framework.