HttpWebRequest.AllowAutoRedirect Propriété

Définition

Obtient ou définit une valeur qui indique si la requête doit suivre les réponses de redirection.Gets or sets a value that indicates whether the request should follow redirection responses.

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é

true si la requête doit suivre automatiquement les réponses de redirection provenant de la ressource Internet ; sinon, false.true if the request should automatically follow redirection responses from the Internet resource; otherwise, false. La valeur par défaut est true.The default value is true.

Exemples

L’exemple de code suivant utilise la propriété AllowAutoRedirect pour permettre à la requête de suivre les réponses de redirection.The following code example uses the AllowAutoRedirect property to allow the request to follow redirection responses.

// 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éfinissez AllowAutoRedirect sur true si vous souhaitez que la demande suive automatiquement les en-têtes de redirection HTTP vers le nouvel emplacement de la ressource.Set AllowAutoRedirect to true if you want the request to automatically follow HTTP redirection headers to the new location of the resource. Le nombre maximal de redirections à suivre est défini par la propriété MaximumAutomaticRedirections.The maximum number of redirections to follow is set by the MaximumAutomaticRedirections property.

Si AllowAutoRedirect est défini sur false, toutes les réponses avec un code d’état HTTP comprise entre 300 et 399 sont retournées à l’application.If AllowAutoRedirect is set to false, all responses with an HTTP status code from 300 to 399 is returned to the application.

L’en-tête d’autorisation est effacé lors des redirections automatiques et HttpWebRequest essaie automatiquement de s’authentifier à nouveau à l’emplacement Redirigé.The Authorization header is cleared on auto-redirects and HttpWebRequest automatically tries to re-authenticate to the redirected location. En pratique, cela signifie qu’une application ne peut pas placer les informations d’authentification personnalisées dans l’en-tête Authorization s’il est possible de rencontrer une redirection.In practice, this means that an application can't put custom authentication information into the Authorization header if it is possible to encounter redirection. Au lieu de cela, l’application doit implémenter et inscrire un module d’authentification personnalisé.Instead, the application must implement and register a custom authentication module. Le System.Net.AuthenticationManager et la classe connexe sont utilisés pour implémenter un module d’authentification personnalisé.The System.Net.AuthenticationManager and related class are used to implement a custom authentication module. La méthode AuthenticationManager.Register inscrit un module d’authentification personnalisé.The AuthenticationManager.Register method registers a custom authentication module.

S’applique à