HttpServerUtility.TransferRequest Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

A megadott URL aszinkron végrehajtását hajtja végre.

Túlterhelések

Name	Description
TransferRequest(String)	A megadott URL aszinkron végrehajtását hajtja végre.
TransferRequest(String, Boolean)	A megadott URL aszinkron végrehajtását hajtja végre, és megőrzi a lekérdezési sztring paramétereit.
TransferRequest(String, Boolean, String, NameValueCollection)	A megadott URL-cím aszinkron végrehajtását hajtja végre a megadott HTTP-módszerrel és fejlécekkel.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	A megadott URL-cím aszinkron végrehajtását hajtja végre a megadott HTTP-módszerrel, fejlécekkel és elérési úttal, és opcionálisan megőrzi az űrlapértékeket és a felhasználói identitást.

Megjegyzések

TransferRequest a .NET Framework 3.5-ös verziójában jelent meg. A .NET-keretrendszerről a Verziók és függőségek című témakörben olvashat.

TransferRequest(String)

A megadott URL aszinkron végrehajtását hajtja végre.

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

public void TransferRequest(string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Paraméterek

path

String

A kiszolgáló új lapjának URL-címe.

Kivételek

PlatformNotSupportedException

A kéréshez az IIS 7.0 integrált folyamatmódja szükséges.

HttpException

A kiszolgáló nem érhető el a kérés kezeléséhez.

ArgumentNullException

A path paraméter a következő null: .

ArgumentException

A path paraméter érvénytelen.

Megjegyzések

Ez a metódus túlterhelésnek hívja meg a TransferRequest túlterhelést a preserveForm paraméter beállítása false, a method paraméter beállítása null, a headers paraméter értéke nullés a preserveUser paraméter értéke true. További információkért lásd a "Megjegyzések" szakaszt a túlterhelésről TransferRequest(String, Boolean, String, NameValueCollection) .

TransferRequest(String, Boolean)

A megadott URL aszinkron végrehajtását hajtja végre, és megőrzi a lekérdezési sztring paramétereit.

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)

Paraméterek

path

String

A kiszolgáló új lapjának URL-címe.

preserveForm

Boolean

true a gyűjtemény megőrzéséhez Form ; false a gyűjtemény törléséhez Form .

Kivételek

PlatformNotSupportedException

A kéréshez az IIS 7.0 integrált folyamatmódja szükséges.

HttpException

A kiszolgáló nem érhető el a kérés kezeléséhez.

ArgumentNullException

A path paraméter a következő null: .

ArgumentException

A path paraméter érvénytelen.

Megjegyzések

Ez a túlterhelés meghívja a TransferRequest túlterhelést a preserveForm paraméter által megadott értékre, a method paraméterre null, az headers értékre és nulla preserveUser paraméterre van állítva true. További információt a "Megjegyzések" című szakaszban TransferRequest(String, Boolean, String, NameValueCollection)talál.

TransferRequest a .NET-keretrendszer 3.5-ös verziójában kerül bevezetésre. További információ: Verziók és függőségek.

TransferRequest(String, Boolean, String, NameValueCollection)

A megadott URL-cím aszinkron végrehajtását hajtja végre a megadott HTTP-módszerrel és fejlécekkel.

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)

Paraméterek

path

String

A kiszolgáló új lapjának URL-címe.

preserveForm

Boolean

true a gyűjtemény megőrzéséhez Form ; false a gyűjtemény törléséhez Form .

method

String

Az új kérés végrehajtásához használandó HTTP-metódus.

headers

NameValueCollection

Egy NameValueCollection kérésfejléc az új kéréshez.

Kivételek

PlatformNotSupportedException

A kéréshez integrált módban kell futtatni az IIS 7.0-t.

HttpException

A kiszolgáló nem érhető el a kérés kezeléséhez.

ArgumentNullException

A path paraméter a következő null: .

ArgumentException

A path paraméter érvénytelen.

Megjegyzések

Ezt a módszert akkor használja a rendszer, ha az IIS 7.0 integrált folyamatmódjával fut, hogy lehetővé tegye a kérésfeldolgozás átvitelét az egyik erőforrástípusból a másikba, miközben a célkérelmet a megfelelő kérelemkörnyezettel hajtja végre. Ezzel a TransferRequest módszerrel például átviheti az ASPX-lapra vonatkozó kéréseket egy XML-lapra.

A TransferRequest metódus a megadott URL-cím aszinkron gyermekvégrehajtását hajtja végre a következő feltételekkel:

• Ha a path paraméter egy lekérdezési sztringet ad meg, az új lekérdezési sztringként lesz használva. Ha nem tartalmaz lekérdezési sztringet, a rendszer újra felhasználja a kérés lekérdezési sztringét.

• Ha a method paraméter meg van adva, azt fogja használni. Ha igen null, az eredeti kérés HTTP-metódusa lesz használva.

• Ha a preserveForm paraméter az true, a kérés aktuális entitástörzse elérhető lesz a célkérelem számára. Ez lehetővé teszi az űrlapbejegyzések és -feltöltések átvitelét.

• Ha a felhasználói identitás jelenleg az eredeti kérelemre van beállítva, az identitás át lesz adva az új kérelemre. Ez lehetővé teszi, hogy a hitelesített kérések újra felhasználják az új kérés hitelesítésének eredményét. Ha nem szeretné, hogy a felhasználó átkerüljön, az átvitel előtt állítsa be a felhasználót null az eredeti kérelemre.

• Ha a headers paraméter meg van adva, az új kérés a megadott fejlécekkel fog futni. Ezzel módosíthatja az új kérelem fejléceit és cookie-jait, vagy hozzáadhat egy speciális fejlécet, amely meghatározza az eredeti kérés fogadásának helyét.

  Ez a metódus a metódus túlterhelését TransferRequest(String, Boolean, String, NameValueCollection, Boolean) hívja meg a preserveUser paraméter beállításával true.

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

A megadott URL-cím aszinkron végrehajtását hajtja végre a megadott HTTP-módszerrel, fejlécekkel és elérési úttal, és opcionálisan megőrzi az űrlapértékeket és a felhasználói identitást.

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)

Paraméterek

path

String

Az elérési út.

preserveForm

Boolean

true a gyűjtemény megőrzéséhez Form ; false a gyűjtemény törléséhez Form .

method

String

Az új kérelemben használni kívánt HTTP-metódus.

headers

NameValueCollection

Az NameValueCollection új kérelem kérelemfejléceit tartalmazó objektum.

preserveUser

Boolean

truea felhasználói identitás megőrzése; egyéb esetben. false A metódus másik metódustúlterheltsége ezt a túlterhelést hívja meg ezzel a paraméterrel true.

Kivételek

PlatformNotSupportedException

A kéréshez az IIS 7.0 integrált folyamatmódja szükséges.

HttpException

A kiszolgáló nem érhető el a kérés kezeléséhez.

ArgumentNullException

A path paraméter a következő null: .

ArgumentException

A path paraméter érvénytelen.

Megjegyzések

További információt a "Megjegyzések" című szakaszban TransferRequest(String, Boolean, String, NameValueCollection)talál.