SocketsHttpHandler.AllowAutoRedirect Eigenschaft

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

SocketsHttpHandler.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 true festAllowAutoRedirect, wenn der Handler den HTTP-Umleitungsheadern automatisch an den neuen Speicherort der Ressource folgen soll. Die maximale Anzahl der folgenden Umleitungen wird durch die MaxAutomaticRedirections -Eigenschaft festgelegt.

Wenn AllowAutoRedirect auf falsefestgelegt 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 erneut am umgeleiteten Speicherort 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 erfolgt, 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

Der Handler folgt nie einer Umleitung von HTTPS zu HTTP, auch wenn AllowAutoRedirect auf truefestgelegt ist.