HttpWebRequest.AllowAutoRedirect Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Anforderung Umleitungsantworten folgen soll, oder legt diesen Wert fest.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

Eigenschaftswert

true, wenn die Anforderung Umleitungsantworten von der Internetressource automatisch folgen soll, andernfalls false.true if the request should automatically follow redirection responses from the Internet resource; otherwise, false. Der Standardwert ist truesein.The default value is true.

Beispiele

Im folgenden Codebeispiel wird die AllowAutoRedirect-Eigenschaft verwendet, damit die Anforderung Umleitungs Antworten befolgt.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)

Hinweise

Legen Sie AllowAutoRedirect auf true fest, wenn die Anforderung http-Umleitungs Headern automatisch an den neuen Speicherort der Ressource weiterleiten soll.Set AllowAutoRedirect to true if you want the request to automatically follow HTTP redirection headers to the new location of the resource. Die maximale Anzahl der nachfolgenden Umleitungen wird durch die MaximumAutomaticRedirections-Eigenschaft festgelegt.The maximum number of redirections to follow is set by the MaximumAutomaticRedirections property.

Wenn AllowAutoRedirect auf falsefestgelegt ist, werden alle Antworten mit einem HTTP-Statuscode zwischen 300 und 399 an die Anwendung zurückgegeben.If AllowAutoRedirect is set to false, all responses with an HTTP status code from 300 to 399 is returned to the application.

Der Autorisierungs Header wird bei automatischen Umleitungen gelöscht, und HttpWebRequest versucht automatisch, sich am umgeleiteten Speicherort erneut zu authentifizieren.The Authorization header is cleared on auto-redirects and HttpWebRequest automatically tries to re-authenticate to the redirected location. In der Praxis bedeutet dies, dass eine Anwendung keine benutzerdefinierten Authentifizierungsinformationen im Autorisierungs Header ablegen kann, wenn eine Umleitung möglich ist.In practice, this means that an application can't put custom authentication information into the Authorization header if it is possible to encounter redirection. Stattdessen muss die Anwendung ein benutzerdefiniertes Authentifizierungs Modul implementieren und registrieren.Instead, the application must implement and register a custom authentication module. Mit dem System.Net.AuthenticationManager und der zugehörigen Klasse wird ein benutzerdefiniertes Authentifizierungs Modul implementiert.The System.Net.AuthenticationManager and related class are used to implement a custom authentication module. Mit der AuthenticationManager.Register-Methode wird ein benutzerdefiniertes Authentifizierungs Modul registriert.The AuthenticationManager.Register method registers a custom authentication module.

Gilt für: