SocketsHttpHandler.AllowAutoRedirect Propriedade

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Origem:

SocketsHttpHandler.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 for definido falsecomo , 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 poderá 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 personalizado.

Se você estiver usando cookies adicionando-os Headers especificamente à coleção, eles não serão limpos quando um redirecionamento for 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

O manipulador nunca segue um redirecionamento de HTTPS para HTTP, mesmo se AllowAutoRedirect estiver definido truecomo .