HttpWebRequest.AllowAutoRedirect Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtient ou définit une valeur qui indique si la requête doit suivre les réponses de redirection.

public:
 virtual property bool AllowAutoRedirect { bool get(); void set(bool value); };

public:
 property bool AllowAutoRedirect { bool get(); void set(bool value); };

public virtual bool AllowAutoRedirect { get; set; }

public bool AllowAutoRedirect { get; set; }

member this.AllowAutoRedirect : bool with get, set

Public Overridable Property AllowAutoRedirect As Boolean

Public Property AllowAutoRedirect As Boolean

Valeur de propriété

Boolean

true si la requête doit suivre automatiquement les réponses de redirection provenant de la ressource Internet ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple de code suivant utilise la AllowAutoRedirect propriété pour permettre à la demande de suivre les réponses de redirection.

// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->MaximumAutomaticRedirections = 1;
myHttpWebRequest->AllowAutoRedirect = true;
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );

// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");	
myHttpWebRequest.MaximumAutomaticRedirections=1;
myHttpWebRequest.AllowAutoRedirect=true;
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();

     'This method creates a new HttpWebRequest Object to the mentioned URL.
         Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
         myHttpWebRequest.MaximumAutomaticRedirections = 1
         myHttpWebRequest.AllowAutoRedirect = True
         Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)

Remarques

Défini AllowAutoRedirect sur true la valeur si vous souhaitez que la requête 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 MaximumAutomaticRedirections propriété.

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

L’en-tête d’autorisation est effacé sur les redirections automatiques et HttpWebRequest tente automatiquement de s’authentifier à nouveau à l’emplacement redirigé. 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 la redirection. Au lieu de cela, l’application doit implémenter et inscrire un module d’authentification personnalisé. La System.Net.AuthenticationManager classe associée est utilisée pour implémenter un module d’authentification personnalisé. La AuthenticationManager.Register méthode inscrit un module d’authentification personnalisé.