HttpClientHandler.AllowAutoRedirect Propriedade

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Assembly:

netstandard.dll

Obtém ou define um valor que indica se o manipulador deve seguir as 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 da propriedade

Boolean

true se o manipulador deve seguir as respostas de redirecionamento; caso contrário false. O valor padrão é true.

Comentários

Defina AllowAutoRedirect como true se você quiser que o manipulador siga automaticamente os cabeçalhos de redirecionamento HTTP para o novo local do recurso. O número máximo de redirecionamentos a seguir é definido pela MaxAutomaticRedirections propriedade.

Se AllowAutoRedirect estiver definido como false, todas as respostas HTTP com um código de status HTTP de 300 a 399 serão retornadas ao aplicativo.

O cabeçalho autorização é limpo em redirecionamentos automáticos e o manipulador tenta automaticamente se autenticar novamente no local redirecionado. Nenhum outro cabeçalho está limpo. Na prática, isso significa que um aplicativo não pode colocar informações de autenticação personalizadas no cabeçalho de Autorização se for possível encontrar o redirecionamento. Em vez disso, o aplicativo deve implementar e registrar um módulo de autenticação personalizado.

Se você estiver usando cookies adicionando-os Headers especificamente à coleção, eles não serão limpos quando um redirecionamento é seguido, pois o manipulador não tem como saber para qual domínio um cookie é permitido. Se você quiser imitar o comportamento do navegador, use a CookieContainer classe que permite especificar o domínio de destino para um cookie.

Observação

Com AllowAutoRedirect definido como true, o .NET Framework seguirá redirecionamentos mesmo quando for redirecionado para um URI HTTP de um URI HTTPS. As versões 1.0, 1.1 e 2.0 do .NET Core não seguirão um redirecionamento de HTTPS para HTTP, mesmo que AllowAutoRedirect esteja definido como true.