HttpWebRequest.AllowAutoRedirect Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Anforderung Umleitungsantworten folgen soll.
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, setPublic Overridable Property AllowAutoRedirect As BooleanPublic Property AllowAutoRedirect As BooleanEigenschaftswert
true, wenn die Anforderung den 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
Vorsicht
WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Legen Sie AllowAutoRedirect auf true fest, wenn die Anforderung den HTTP-Umleitungsheadern automatisch an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl der zu befolgenden Umleitungen wird durch die eigenschaft MaximumAutomaticRedirections festgelegt.
Wenn AllowAutoRedirect auf falsefestgelegt ist, werden alle Antworten mit einem HTTP-Statuscode von 300 bis 399 an die Anwendung zurückgegeben.
Der Autorisierungsheader wird bei automatischen Umleitungen gelöscht und HttpWebRequest versucht automatisch, sich beim 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 und die zugehörige Klasse werden verwendet, um ein benutzerdefiniertes Authentifizierungsmodul zu implementieren. Die AuthenticationManager.Register-Methode registriert ein benutzerdefiniertes Authentifizierungsmodul.
