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
truewenn die Anforderung automatisch den Umleitungsantworten von der Internetressource folgen soll; andernfalls . false Der Standardwert ist true.
Beispiele
Im folgenden Codebeispiel wird die AllowAutoRedirect Eigenschaft verwendet, um es der Anforderung zu ermöglichen, Umleitungsantworten zu folgen.
// 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 fest AllowAutoRedirecttrue , ob die Anforderung automatisch HTTP-Umleitungsheader an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl der zu befolgenden Umleitungen wird von der MaximumAutomaticRedirections Eigenschaft festgelegt.
Wenn dieser Wert auf falseAllowAutoRedirect festgelegt 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.
