HttpServerUtility.TransferRequest Metod

Definition

Utför en asynkron körning av den angivna URL:en.

Överlagringar

Name Description
TransferRequest(String)

Utför en asynkron körning av den angivna URL:en.

TransferRequest(String, Boolean)

Utför en asynkron körning av den angivna URL:en och bevarar frågesträngsparametrar.

TransferRequest(String, Boolean, String, NameValueCollection)

Utför en asynkron körning av den angivna URL:en med den angivna HTTP-metoden och rubrikerna.

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

Utför en asynkron körning av den angivna URL:en med den angivna HTTP-metoden, rubrikerna och sökvägen och bevarar eventuellt formulärvärden och användaridentiteten.

Kommentarer

TransferRequest introducerades i .NET Framework version 3.5. Sammanfattningsinformation om .NET Framework finns i Versioner och beroenden.

TransferRequest(String)

Utför en asynkron körning av den angivna URL:en.

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

Parametrar

path
String

URL-sökvägen till den nya sidan på servern som ska köras.

Undantag

Begäran kräver det integrerade pipelineläget i IIS 7.0.

Servern är inte tillgänglig för att hantera begäran.

Parametern path är null.

Parametern path är ogiltig.

Kommentarer

Den här metodens överlagring anropar överlagringen TransferRequest med parametern preserveForm inställd på false, parametern method inställd nullpå , parametern headers inställd nullpå och parametern preserveUser inställd på true. Mer information finns i avsnittet "Anmärkningar" i TransferRequest(String, Boolean, String, NameValueCollection) överlagring.

Gäller för

TransferRequest(String, Boolean)

Utför en asynkron körning av den angivna URL:en och bevarar frågesträngsparametrar.

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)

Parametrar

path
String

URL-sökvägen till den nya sidan på servern som ska köras.

preserveForm
Boolean

true för att bevara Form samlingen, false för att rensa Form samlingen.

Undantag

Begäran kräver det integrerade pipelineläget i IIS 7.0.

Servern är inte tillgänglig för att hantera begäran.

Parametern path är null.

Parametern path är ogiltig.

Kommentarer

Den här överlagringen anropar överlagringen TransferRequest med parametern preserveForm inställd på det värde som skickades in, parametern method inställd på null, parametern headers inställd på nulloch parametern preserveUser inställd på true. Mer information finns i avsnittet "Anmärkningar" i TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest introduceras i .NET Framework version 3.5. Mer information finns i Versioner och beroenden.

Gäller för

TransferRequest(String, Boolean, String, NameValueCollection)

Utför en asynkron körning av den angivna URL:en med den angivna HTTP-metoden och rubrikerna.

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)

Parametrar

path
String

URL-sökvägen till den nya sidan på servern som ska köras.

preserveForm
Boolean

true för att bevara Form samlingen, false för att rensa Form samlingen.

method
String

DEN HTTP-metod som ska användas i körningen av den nya begäran.

headers
NameValueCollection

En NameValueCollection av begärandehuvuden för den nya begäran.

Undantag

Begäran kräver att IIS 7.0 körs i integrerat läge.

Servern är inte tillgänglig för att hantera begäran.

Parametern path är null.

Parametern path är ogiltig.

Kommentarer

Den här metoden används när du kör med det integrerade pipelineläget i IIS 7.0 för att tillåta att bearbetning av begäranden överförs från en resurstyp till en annan när målbegäran körs med rätt begärandekontext. Du kan till exempel använda TransferRequest metoden för att överföra en begäran om en ASPX-sida till en begäran om en XML-sida.

Metoden TransferRequest utför en asynkron underordnad körning av den angivna URL:en med följande villkor:

  • Om parametern path anger en frågesträng används den som den nya frågesträngen. Om ingen frågesträng ingår kommer frågesträngen för begäran att återanvändas.

  • Om parametern method anges används den. Om det är nullanvänds HTTP-metoden för den ursprungliga begäran.

  • Om parametern preserveForm är trueblir den aktuella entitetstexten i begäran tillgänglig för målbegäran. Detta gör att formulärposter och uppladdningar kan överföras.

  • Om användaridentiteten för närvarande har angetts för den ursprungliga begäran överförs identiteten till den nya begäran. På så sätt kan autentiserade begäranden återanvända resultatet av autentiseringen för den nya begäran. Om du inte vill att användaren ska överföras ställer du in användaren null på den ursprungliga begäran innan du överför den.

  • Om parametern headers anges körs den nya begäran med de angivna rubrikerna. Detta kan användas för att ändra begärandehuvuden och cookies för den nya begäran eller lägga till en särskild rubrik som anger var den ursprungliga begäran togs emot.

    Den här metoden anropar TransferRequest(String, Boolean, String, NameValueCollection, Boolean) metodens överlagring med parametern inställd på preserveUsertrue.

Gäller för

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

Utför en asynkron körning av den angivna URL:en med den angivna HTTP-metoden, rubrikerna och sökvägen och bevarar eventuellt formulärvärden och användaridentiteten.

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)

Parametrar

path
String

Sökvägen.

preserveForm
Boolean

true för att bevara Form samlingen, false för att rensa Form samlingen.

method
String

DEN HTTP-metod som ska användas i den nya begäran.

headers
NameValueCollection

Ett NameValueCollection objekt som innehåller begärandehuvuden för den nya begäran.

preserveUser
Boolean

trueför att bevara användaridentiteten. annars . false De andra metodöverlagringarna för den här metoden anropar den här överlagringen med den här parametern inställd på true.

Undantag

Begäran kräver det integrerade pipelineläget i IIS 7.0.

Servern är inte tillgänglig för att hantera begäran.

Parametern path är null.

Parametern path är ogiltig.

Kommentarer

Mer information finns i avsnittet "Anmärkningar" i TransferRequest(String, Boolean, String, NameValueCollection).

Gäller för