HttpServerUtility.TransferRequest Methode

public:
 void TransferRequest(System::String ^ path);

public void TransferRequest (string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parameter

Ausnahmen

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.

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

Ausnahmen

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.

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

Ausnahmen

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.

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

Ausnahmen

Hinweise

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