SocketsHttpHandler.AllowAutoRedirect Propriété

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

Source:

SocketsHttpHandler.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 HTTP status de 300 à 399 sont retournées à l’application.

L’en-tête d’autorisation est effacé sur les redirections automatiques et le gestionnaire tente automatiquement de s’authentifier à nouveau à 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 Authorization 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, ceux-ci ne sont pas effacés lorsqu’une redirection est suivie, car le gestionnaire n’a aucun moyen de savoir pour 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

Le gestionnaire ne suit jamais une redirection de HTTPS vers HTTP, même si AllowAutoRedirect est défini sur true.