HttpWebRequest.AllowAutoRedirect Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Anforderung Umleitungsantworten folgen soll, oder legt diesen Wert fest.

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

Eigenschaftswert

true, wenn die Anforderung Umleitungsantworten von der Internetressource automatisch folgen soll, andernfalls false. Der Standardwert ist true.

Beispiele

Im folgenden Codebeispiel wird die AllowAutoRedirect -Eigenschaft verwendet, um der Anforderung das Folgen von Umleitungsantworten zu ermöglichen.

// 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 auf fest AllowAutoRedirecttrue , wenn die Anforderung automatisch http-Umleitungsheadern an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl der folgenden Umleitungen wird durch die MaximumAutomaticRedirections -Eigenschaft festgelegt.

Wenn AllowAutoRedirect auf falsefestgelegt ist, werden alle Antworten mit einem HTTP-status Code von 300 bis 399 an die Anwendung zurückgegeben.

Der Autorisierungsheader wird bei automatischen Umleitungen gelöscht und HttpWebRequest versucht automatisch, sich am umgeleiteten Speicherort erneut zu authentifizieren. In der Praxis bedeutet dies, dass eine Anwendung keine benutzerdefinierten Authentifizierungsinformationen in den Autorisierungsheader einfügen kann, wenn eine Umleitung möglich ist. Stattdessen muss die Anwendung ein benutzerdefiniertes Authentifizierungsmodul implementieren und registrieren. Die System.Net.AuthenticationManager -Klasse und die zugehörige Klasse werden verwendet, um ein benutzerdefiniertes Authentifizierungsmodul zu implementieren. Die AuthenticationManager.Register -Methode registriert ein benutzerdefiniertes Authentifizierungsmodul.

Gilt für: