HttpClientHandler.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 der Handler Umleitungsantworten folgen soll.
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 der Handler Antworten auf Umleitungen befolgen soll; andernfalls false. Der Standardwert ist true.
Hinweise
Legen Sie fest AllowAutoRedirecttrue , ob der Handler automatisch HTTP-Umleitungsheader an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl der zu befolgenden Umleitungen wird von der MaxAutomaticRedirections Eigenschaft festgelegt.
Wenn dieser Wert auf falseAllowAutoRedirect festgelegt ist, werden alle HTTP-Antworten mit einem HTTP-Statuscode von 300 bis 399 an die Anwendung zurückgegeben.
Der Autorisierungsheader wird bei automatischen Umleitungen gelöscht, und der Handler versucht automatisch, sich beim umgeleiteten Speicherort erneut zu authentifizieren. Es werden keine anderen Kopfzeilen gelöscht. 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.
Wenn Sie Cookies verwenden, indem Sie sie speziell zur Headers Sammlung hinzufügen, werden diese nicht gelöscht, wenn eine Umleitung befolgt wird, da der Handler keine Möglichkeit hat zu wissen, für welche Domäne ein Cookie zulässig ist. Wenn Sie das Browserverhalten imitieren möchten, verwenden Sie die Klasse, mit der CookieContainer Sie die Zieldomäne für ein Cookie angeben können.
Hinweis
Bei .NET Core und .NET 5 und höheren Versionen AllowAutoRedirecttrue wird die automatische Umleitung zu einem HTTP-URI von einem HTTPS-URI nicht aktiviert.
Solche (sicher zu unsicheren) Umleitungen werden nur auf .NET Framework befolgt.