HttpClientHandler.AllowAutoRedirect Eigenschaft

  • Referenz

Definition

Namespace:
System.Net.Http
Assembly:
System.Net.Http.dll
Assembly:
netstandard.dll

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

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

Boolean

true wenn der Handler antworten sollte; andernfalls false. Der Standardwert ist true.

Hinweise

Legen Sie fest AllowAutoRedirect true , ob der Handler automatisch HTTP-Umleitungsheader an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl der zu befolgenden Umleitungen wird durch die MaxAutomaticRedirections Eigenschaft festgelegt.

Wenn AllowAutoRedirect festgelegt falseist, 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 erneut an den umgeleiteten Speicherort zu authentifizieren. Keine anderen Kopfzeilen werden 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 gefolgt wird, da der Handler keine Möglichkeit hat, zu wissen, für welche Domäne ein Cookie zulässig ist. Wenn Sie das Browserverhalten nachahmen möchten, verwenden Sie die Klasse, mit der CookieContainer Sie die Zieldomäne für ein Cookie angeben können.

Hinweis

Mit AllowAutoRedirect festgelegter Eigenschaft truefolgt der .NET Framework Umleitungen, auch wenn sie von einem HTTPS-URI an einen HTTP-URI umgeleitet werden. .NET Core-Versionen 1.0, 1.1 und 2.0 folgen keine Umleitung von HTTPS zu HTTP, auch wenn AllowAutoRedirect festgelegt trueauf .

Gilt für