HttpServerUtility.TransferRequest Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Provede asynchronní spuštění zadané adresy URL.

Přetížení

TransferRequest(String)	Provede asynchronní spuštění zadané adresy URL.
TransferRequest(String, Boolean)	Provede asynchronní spuštění zadané adresy URL a zachová parametry řetězce dotazu.
TransferRequest(String, Boolean, String, NameValueCollection)	Provede asynchronní spuštění zadané adresy URL pomocí zadané metody HTTP a hlaviček.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Provede asynchronní spuštění zadané adresy URL pomocí zadané metody HTTP, hlaviček a cesty a volitelně zachová hodnoty formulářů a identitu uživatele.

Poznámky

TransferRequestbyla zavedena v .NET Framework verze 3.5. Souhrnné informace o .NET Framework naleznete v tématu Verze a závislosti.

TransferRequest(String)

Provede asynchronní spuštění zadané adresy URL.

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

public void TransferRequest (string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parametry

path

String

Cesta URL nové stránky na serveru, která se má spustit.

Výjimky

PlatformNotSupportedException

Požadavek vyžaduje režim integrovaného kanálu služby IIS 7.0.

HttpException

Server není k dispozici pro zpracování požadavku.

ArgumentNullException

Parametr path je null.

ArgumentException

Parametr path je neplatný.

Poznámky

Přetížení této metody volá TransferRequest přetížení s parametrem preserveForm nastaveným na false, method parametr nastavený na null, headers parametr nastaven na nulla parametr nastaven na preserveUser true. Další informace najdete v části Poznámky v TransferRequest(String, Boolean, String, NameValueCollection) přetížení.

TransferRequest(String, Boolean)

Provede asynchronní spuštění zadané adresy URL a zachová parametry řetězce dotazu.

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)

Parametry

path

String

Cesta URL nové stránky na serveru, která se má spustit.

preserveForm

Boolean

true zachovat kolekci Form ; false vymazat kolekci Form .

Výjimky

PlatformNotSupportedException

Požadavek vyžaduje režim integrovaného kanálu služby IIS 7.0.

HttpException

Server není k dispozici pro zpracování požadavku.

ArgumentNullException

Parametr path je null.

ArgumentException

Parametr path je neplatný.

Poznámky

Toto přetížení volá TransferRequest přetížení s parametrem preserveForm nastaveným na hodnotu předanou, method parametr nastavený na null, headers parametr nastaven na nulla preserveUser parametr nastavený na true. Další informace naleznete v části "Poznámky" v části TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequestje zaveden v .NET Framework verze 3.5. Další informace naleznete v tématu Verze a závislosti.

TransferRequest(String, Boolean, String, NameValueCollection)

Provede asynchronní spuštění zadané adresy URL pomocí zadané metody HTTP a hlaviček.

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)

Parametry

path

String

Cesta URL nové stránky na serveru, která se má spustit.

preserveForm

Boolean

true zachovat kolekci Form ; false vymazat kolekci Form .

method

String

Metoda HTTP, která se má použít při provádění nového požadavku.

headers

NameValueCollection

Hlavičky NameValueCollection požadavku pro nový požadavek.

Výjimky

PlatformNotSupportedException

Požadavek vyžaduje, aby služba IIS 7.0 běžela v integrovaném režimu.

HttpException

Server není k dispozici pro zpracování požadavku.

ArgumentNullException

Parametr path je null.

ArgumentException

Parametr path je neplatný.

Poznámky

Tato metoda se používá při spuštění s integrovaným režimem kanálu ve službě IIS 7.0, aby bylo možné zpracování požadavků přenést z jednoho typu prostředku do druhého při provádění cílového požadavku se správným kontextem požadavku. Pomocí metody můžete TransferRequest například přenést požadavek na stránku ASPX na žádost o stránku XML.

Metoda TransferRequest provede asynchronní podřízené spuštění zadané adresy URL s následujícími podmínkami:

• path Pokud parametr určuje řetězec dotazu, použije se jako nový řetězec dotazu. Pokud není zahrnut žádný řetězec dotazu, řetězec dotazu požadavku se znovu použije.

• method Pokud je parametr zadán, použije se. Pokud ano null, použije se metoda HTTP původního požadavku.

• Pokud je preserveForm trueparametr , bude pro cílový požadavek k dispozici aktuální text entity požadavku. To umožňuje převést příspěvky a nahrávání formulářů.

• Pokud je identita uživatele aktuálně nastavená na původní požadavek, bude identita převedena na novou žádost. To umožňuje ověřeným požadavkům znovu použít výsledek ověřování pro nový požadavek. Pokud nechcete, aby byl uživatel převeden, nastavte uživatele na null původní žádost před převodem.

• headers Pokud je parametr zadán, spustí se nový požadavek se zadanými hlavičkami. Můžete ho použít k úpravě hlaviček a souborů cookie požadavku pro nový požadavek nebo k přidání speciální hlavičky, která určuje, kde byl původní požadavek přijat.

  Tato metoda volá TransferRequest(String, Boolean, String, NameValueCollection, Boolean) přetížení metody s parametrem preserveUser nastaveným na true.

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

Provede asynchronní spuštění zadané adresy URL pomocí zadané metody HTTP, hlaviček a cesty a volitelně zachová hodnoty formulářů a identitu uživatele.

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)

Parametry

path

String

Cesta.

preserveForm

Boolean

true zachovat kolekci Form ; false vymazat kolekci Form .

method

String

Metoda HTTP, která se má použít v novém požadavku.

headers

NameValueCollection

Objekt NameValueCollection , který obsahuje hlavičky požadavku pro nový požadavek.

preserveUser

Boolean

true zachovat identitu uživatele; falsev opačném případě . Ostatní přetížení metody této metody volají toto přetížení s tímto parametrem nastaveným na true.

Výjimky

PlatformNotSupportedException

Požadavek vyžaduje režim integrovaného kanálu služby IIS 7.0.

HttpException

Server není k dispozici pro zpracování požadavku.

ArgumentNullException

Parametr path je null.

ArgumentException

Parametr path je neplatný.

Poznámky

Další informace naleznete v části "Poznámky" v části TransferRequest(String, Boolean, String, NameValueCollection).