HttpClientHandler.AllowAutoRedirect Eigenschaft

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

HttpClientHandler.cs

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 Umleitungsantworten folgen soll; andernfalls false. Der Standardwert ist true.

Hinweise

Legen Sie auf fest AllowAutoRedirecttrue , wenn der Handler http-Umleitungsheader automatisch an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl von Umleitungen, die folgen sollen, wird von der MaxAutomaticRedirections -Eigenschaft festgelegt.

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

Der Autorisierungsheader wird bei automatischen Umleitungen gelöscht, und der Handler versucht automatisch, sich am umgeleiteten Speicherort erneut zu authentifizieren. Es werden keine anderen Header 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 folgt, da der Handler nicht wissen kann, für welche Domäne ein Cookie zulässig ist. Wenn Sie das Browserverhalten imitieren möchten, verwenden Sie die CookieContainer -Klasse, mit der Sie die Zieldomäne für ein Cookie angeben können.

Hinweis

Wenn AllowAutoRedirect auf truefestgelegt ist, folgt der .NET Framework Umleitungen, auch wenn von einem HTTPS-URI an einen HTTP-URI umgeleitet wird. Die .NET Core-Versionen 1.0, 1.1 und 2.0 folgen keiner Umleitung von HTTPS zu HTTP, auch wenn AllowAutoRedirect auf truefestgelegt ist.