HttpClientHandler.AllowAutoRedirect Propriedade

Definição

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.

Aplica-se a