HttpServerUtility.TransferRequest Methode

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

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.

Führt eine asynchrone Ausführung der angegebenen URL aus.

Überlädt

Name	Beschreibung
TransferRequest(String)	Führt eine asynchrone Ausführung der angegebenen URL aus.
TransferRequest(String, Boolean)	Führt eine asynchrone Ausführung der angegebenen URL aus und behält Abfragezeichenfolgenparameter bei.
TransferRequest(String, Boolean, String, NameValueCollection)	Führt eine asynchrone Ausführung der angegebenen URL mithilfe der angegebenen HTTP-Methode und Header aus.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Führt eine asynchrone Ausführung der angegebenen URL mithilfe der angegebenen HTTP-Methode, Header und Pfad durch und behält optional Formularwerte und die Benutzeridentität bei.

Hinweise

TransferRequest wurde in der .NET Framework Version 3.5 eingeführt. Zusammenfassungsinformationen zum .NET Framework finden Sie unter Versions and Dependencies.

TransferRequest(String)

Führt eine asynchrone Ausführung der angegebenen URL 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 der neuen Seite auf dem Server, die ausgeführt werden soll.

Ausnahmen

PlatformNotSupportedException

Für die Anforderung ist der integrierte Pipelinemodus von IIS 7.0 erforderlich.

HttpException

Der Server ist nicht für die Verarbeitung der Anforderung verfügbar.

ArgumentNullException

Der path Parameter ist null.

ArgumentException

Der parameter path ist ungültig.

Hinweise

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

Gilt für:

TransferRequest(String, Boolean)

Führt eine asynchrone Ausführung der angegebenen URL aus und behält Abfragezeichenfolgenparameter 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 der neuen Seite auf dem Server, die ausgeführt werden soll.

preserveForm: Boolean

true um die Form Sammlung beizubehalten; false um die Form Sammlung zu löschen.

Ausnahmen

PlatformNotSupportedException

Für die Anforderung ist der integrierte Pipelinemodus von IIS 7.0 erforderlich.

HttpException

Der Server ist nicht für die Verarbeitung der Anforderung verfügbar.

ArgumentNullException

Der path Parameter ist null.

ArgumentException

Der parameter path ist ungültig.

Hinweise

Diese Überladung ruft die TransferRequest Überladung mit dem preserveForm parametersatz auf den übergebenen Wert, den method parameter set auf null, den headers parameter set auf null, und den preserveUser Parameter auf true. Weitere Informationen finden Sie im Abschnitt "Hinweise" in TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest wird 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 eine asynchrone Ausführung der angegebenen URL mithilfe der angegebenen HTTP-Methode und Header 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 der neuen Seite auf dem Server, die ausgeführt werden soll.

preserveForm: Boolean

true um die Form Sammlung beizubehalten; false um die Form Sammlung zu löschen.

method: String

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

headers: NameValueCollection

Eine NameValueCollection Der Anforderungsheader für die neue Anforderung.

Ausnahmen

PlatformNotSupportedException

Für die Anforderung ist IIS 7.0 erforderlich, die im integrierten Modus ausgeführt werden.

HttpException

Der Server ist nicht für die Verarbeitung der Anforderung verfügbar.

ArgumentNullException

Der path Parameter ist null.

ArgumentException

Der parameter path 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 z. B. 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 er als neue Abfragezeichenfolge verwendet. Wenn keine Abfragezeichenfolge enthalten ist, wird die Abfragezeichenfolge der Anforderung erneut verwendet.
Wenn der method Parameter angegeben ist, wird er verwendet. Wenn dies der Grund ist null, wird die HTTP-Methode der ursprünglichen Anforderung verwendet.
Wenn der preserveForm Parameter lautet true, ist der aktuelle Entitätstext der Anforderung für die Zielanforderung verfügbar. Dadurch können Formularbeiträge und Uploads übertragen werden.
Wenn die Benutzeridentität derzeit für die ursprüngliche 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 Sie nicht möchten, dass der Benutzer übertragen wird, 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 auf, wobei der preserveUser Parameter auf true.

Gilt für:

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

Führt eine asynchrone Ausführung der angegebenen URL mithilfe der angegebenen HTTP-Methode, Header und Pfad durch und behält optional Formularwerte und die Benutzeridentität 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 Sammlung beizubehalten; false um die Form Sammlung zu löschen.

method: String

Die HTTP-Methode, die in der neuen Anforderung verwendet werden soll.

headers: NameValueCollection

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

preserveUser: Boolean

trueum die Benutzeridentität zu erhalten; andernfalls . false Die anderen Methodenüberladungen dieser Methode rufen diese Überladung auf, wobei dieser Parameter auf . true festgelegt ist.

Ausnahmen

PlatformNotSupportedException

Für die Anforderung ist der integrierte Pipelinemodus von IIS 7.0 erforderlich.

HttpException

Der Server ist nicht für die Verarbeitung der Anforderung verfügbar.

ArgumentNullException

Der path Parameter ist null.

ArgumentException

Der parameter path ist ungültig.

Hinweise

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

Gilt für:

Feedback

War diese Seite hilfreich?