Freigeben über


HttpServerUtility.TransferRequest Methode

Definition

Führt die angegebene URL asynchron aus.

Überlädt

TransferRequest(String)

Führt die angegebene URL asynchron aus.

TransferRequest(String, Boolean)

Führt die angegebene URL asynchron aus und behält die Parameter der Abfragezeichenfolge bei.

TransferRequest(String, Boolean, String, NameValueCollection)

Führt die angegebene URL mit der angegebenen HTTP-Methode und den angegebenen HTTP-Headern asynchron aus.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Nimmt eine asynchrone Ausführung der angegebenen URL mit der angegebenen HTTP-Methode, den angegebenen HTTP-Headern und dem angegebenen HTTP-Pfad vor und behält die Formularwerte und Benutzeridentität optional bei.

Hinweise

TransferRequestwurde in der .NET Framework Version 3.5 eingeführt. Zusammenfassungsinformationen zu den .NET Framework finden Sie unter Versions- und Abhängigkeiten.

TransferRequest(String)

Führt die angegebene URL asynchron aus.

public:
 void TransferRequest(System::String ^ path);
public void TransferRequest (string path);
member this.TransferRequest : string -> unit
Public Sub TransferRequest (path As String)

Parameter

path
String

Der URL-Pfad für die neue auszuführende Seite auf dem Server.

Ausnahmen

Die Anforderung erfordert den integrierten Pipelinemodus von IIS 7.0.

Der Server ist nicht verfügbar, um die Anforderung zu verarbeiten.

Der path-Parameter ist null.

Der path-Parameter ist ungültig.

Hinweise

Diese Methodenüberladung ruft die TransferRequest Überladung mit dem preserveForm Parametersatz auf , dem null``method Parametersatz falseauf , dem Parametersatz auf , dem headers Parametersatz auf null, und dem preserveUser Parametersatz auf true. Weitere Informationen finden Sie im Abschnitt "Hinweise" in TransferRequest(String, Boolean, String, NameValueCollection) Überladung.

Gilt für

TransferRequest(String, Boolean)

Führt die angegebene URL asynchron aus und behält die Parameter der Abfragezeichenfolge bei.

public:
 void TransferRequest(System::String ^ path, bool preserveForm);
public void TransferRequest (string path, bool preserveForm);
member this.TransferRequest : string * bool -> unit
Public Sub TransferRequest (path As String, preserveForm As Boolean)

Parameter

path
String

Der URL-Pfad für die neue auszuführende Seite auf dem Server.

preserveForm
Boolean

true, um die Form-Auflistung beizubehalten; false, um die Form-Auflistung zu löschen.

Ausnahmen

Die Anforderung erfordert den integrierten Pipelinemodus von IIS 7.0.

Der Server ist nicht verfügbar, um die Anforderung zu verarbeiten.

Der path-Parameter ist null.

Der path-Parameter ist ungültig.

Hinweise

Bei dieser Überladung wird die TransferRequest Überladung mit dem Parameter aufgerufen, der preserveForm auf den übergebenen Wert festgelegt ist, auf den method parameter festgelegt null, auf den headers Parameter festgelegt nullist, und der preserveUser Parameter auf true. Weitere Informationen finden Sie im Abschnitt "Hinweise" in TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequestwird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für

TransferRequest(String, Boolean, String, NameValueCollection)

Führt die angegebene URL mit der angegebenen HTTP-Methode und den angegebenen HTTP-Headern asynchron aus.

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);
public void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);
member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit
Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)

Parameter

path
String

Der URL-Pfad für die neue auszuführende Seite auf dem Server.

preserveForm
Boolean

true, um die Form-Auflistung beizubehalten; false, um die Form-Auflistung zu löschen.

method
String

Die HTTP-Methode, die für die Ausführung der neuen Anforderung verwendet werden soll.

headers
NameValueCollection

Eine NameValueCollection von Anforderungsheadern für die neue Anforderung.

Ausnahmen

Die Anforderung erfordert IIS 7.0, die im integrierten Modus ausgeführt werden.

Der Server ist nicht verfügbar, um die Anforderung zu verarbeiten.

Der path-Parameter ist null.

Der path-Parameter ist ungültig.

Hinweise

Diese Methode wird verwendet, wenn sie mit dem integrierten Pipelinemodus in IIS 7.0 ausgeführt wird, damit die Anforderungsverarbeitung von einem Ressourcentyp in einen anderen übertragen werden kann, während die Zielanforderung mit dem richtigen Anforderungskontext ausgeführt wird. Sie können beispielsweise die TransferRequest Methode verwenden, um eine Anforderung für eine ASPX-Seite an eine Anforderung für eine XML-Seite zu übertragen.

Die TransferRequest Methode führt eine asynchrone untergeordnete Ausführung der angegebenen URL mit den folgenden Bedingungen aus:

  • Wenn der path Parameter eine Abfragezeichenfolge angibt, wird sie als neue Abfragezeichenfolge verwendet. Wenn keine Abfragezeichenfolge enthalten ist, wird die Abfragezeichenfolge der Anforderung erneut verwendet.

  • Wenn der method Parameter angegeben wird, wird er verwendet. Wenn dies der Vorgang ist null, wird die HTTP-Methode der ursprünglichen Anforderung verwendet.

  • Wenn der preserveForm Parameter lautet, steht trueder aktuelle Entitätstext der Anforderung für die Zielanforderung zur Verfügung. Dadurch können Formularbeiträge und Uploads übertragen werden.

  • Wenn die Benutzeridentität derzeit auf der ursprünglichen Anforderung festgelegt ist, wird die Identität an die neue Anforderung übertragen. Dadurch können authentifizierte Anforderungen das Ergebnis der Authentifizierung für die neue Anforderung erneut verwenden. Wenn Der Benutzer nicht übertragen werden soll, legen Sie den Benutzer null vor der Übertragung auf die ursprüngliche Anforderung fest.

  • Wenn der headers Parameter angegeben ist, wird die neue Anforderung mit den angegebenen Headern ausgeführt. Dies kann verwendet werden, um die Anforderungsheader und Cookies für die neue Anforderung zu ändern oder einen speziellen Header hinzuzufügen, der angibt, wo die ursprüngliche Anforderung empfangen wurde.

    Diese Methode ruft die TransferRequest(String, Boolean, String, NameValueCollection, Boolean) Methodenüberladung mit dem preserveUser Parametersatz auf true.

Gilt für

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Nimmt eine asynchrone Ausführung der angegebenen URL mit der angegebenen HTTP-Methode, den angegebenen HTTP-Headern und dem angegebenen HTTP-Pfad vor und behält die Formularwerte und Benutzeridentität optional bei.

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);
public void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);
member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit
Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)

Parameter

path
String

Der Pfad.

preserveForm
Boolean

true, um die Form-Auflistung beizubehalten; false, um die Form-Auflistung zu löschen.

method
String

Die HTTP-Methode für die neue Anforderung.

headers
NameValueCollection

Ein NameValueCollection-Objekt, das Anforderungsheader für die neue Anforderung enthält.

preserveUser
Boolean

true, um die Benutzeridentität zu erhalten; andernfalls false. Die anderen Überladungen dieser Methode rufen diese Überladung mit diesem auf true gesetzten Parameter auf.

Ausnahmen

Die Anforderung erfordert den integrierten Pipelinemodus von IIS 7.0.

Der Server ist nicht verfügbar, um die Anforderung zu verarbeiten.

Der path-Parameter ist null.

Der path-Parameter ist ungültig.

Hinweise

Weitere Informationen finden Sie im Abschnitt "Hinweise" in TransferRequest(String, Boolean, String, NameValueCollection).

Gilt für