HttpClientHandler.AllowAutoRedirect Propriedade

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Origem:

HttpClientHandler.cs

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 http status 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 é limpo. Na prática, isso significa que um aplicativo não pode colocar informações de autenticação personalizadas no cabeçalho autorização se for possível encontrar o redirecionamento. Em vez disso, o aplicativo deve implementar e registrar um módulo de autenticação personalizada.

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.