HttpClientHandler.AllowAutoRedirect Propriété

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

Source:

HttpClientHandler.cs

Obtient ou définit une valeur qui indique si le gestionnaire doit suivre les réponses de redirection.

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

Valeur de propriété

Boolean

true si le gestionnaire doit suivre les réponses de redirection ; sinon false, . La valeur par défaut est true.

Remarques

Définissez AllowAutoRedirect sur true si vous souhaitez que le gestionnaire suive automatiquement les en-têtes de redirection HTTP vers le nouvel emplacement de la ressource. Le nombre maximal de redirections à suivre est défini par la MaxAutomaticRedirections propriété .

Si AllowAutoRedirect a la valeur false, toutes les réponses HTTP avec un code de status HTTP de 300 à 399 sont retournées à l’application.

L’en-tête d’autorisation est effacé lors de la redirection automatique et le gestionnaire tente automatiquement de s’authentifier à nouveau auprès de l’emplacement redirigé. Aucun autre en-tête n’est effacé. Dans la pratique, cela signifie qu’une application ne peut pas placer d’informations d’authentification personnalisées dans l’en-tête d’autorisation s’il est possible de rencontrer une redirection. Au lieu de cela, l’application doit implémenter et inscrire un module d’authentification personnalisé.

Si vous utilisez des cookies en les ajoutant spécifiquement à la Headers collection, ils ne sont pas effacés lorsqu’une redirection est suivie, car le gestionnaire n’a aucun moyen de savoir quel domaine un cookie est autorisé. Si vous souhaitez imiter le comportement du navigateur, utilisez la CookieContainer classe qui vous permet de spécifier le domaine cible d’un cookie.

Notes

Avec AllowAutoRedirect la valeur définie sur true, le .NET Framework suit les redirections même lorsqu’il est redirigé vers un URI HTTP à partir d’un URI HTTPS. .NET Core versions 1.0, 1.1 et 2.0 ne suivent pas une redirection de HTTPS vers HTTP, même si AllowAutoRedirect est défini sur true.