HttpServerUtility.TransferRequest Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Provede asynchronní spuštění zadané adresy URL.
Přetížení
| Name | Description |
|---|---|
| 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
TransferRequest byl zaveden v rozhraní .NET Framework verze 3.5. Souhrnné informace o .NET Framework najdete 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á provést.
Výjimky
Požadavek vyžaduje režim integrovaného kanálu služby IIS 7.0.
Server není k dispozici pro zpracování požadavku.
Parametr path je null.
Parametr path je neplatný.
Poznámky
Tato metoda přetížení volá přetížení s TransferRequest parametrem nastaveným na preserveForm, false parametr nastaven methodna , null parametr nastaven na headers, a null parametr nastaven na preserveUser.true Další informace naleznete v části Poznámky v TransferRequest(String, Boolean, String, NameValueCollection) přetížení.
Platí pro
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á provést.
Výjimky
Požadavek vyžaduje režim integrovaného kanálu služby IIS 7.0.
Server není k dispozici pro zpracování požadavku.
Parametr path je null.
Parametr path je neplatný.
Poznámky
Toto přetížení volá TransferRequest přetížení s preserveForm parametrem 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 TransferRequest(String, Boolean, String, NameValueCollection)části .
TransferRequest je zaveden v rozhraní .NET Framework verze 3.5. Další informace naleznete v tématu Verze a závislosti.
Platí pro
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á provést.
- 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
Požadavek vyžaduje, aby služba IIS 7.0 běžela v integrovaném režimu.
Server není k dispozici pro zpracování požadavku.
Parametr path je null.
Parametr path je neplatný.
Poznámky
Tato metoda se používá při spuštění s režimem integrovaného kanálu ve službě IIS 7.0, aby bylo možné přenést zpracování požadavků 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. Metodu můžete například použít k převodu TransferRequest požadavku na stránku ASPX na požadavek na stránku XML.
Metoda TransferRequest provede asynchronní podřízené spuštění zadané adresy URL s následujícími podmínkami:
pathPokud 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.methodPokud je parametr zadán, použije se. Pokud anonull, použije se metoda HTTP původního požadavku.preserveFormPokud jetrueparametr, bude pro cílový požadavek k dispozici aktuální tělo entity požadavku. To umožňuje přenos příspěvků formulářů a nahrávání.Pokud je identita uživatele aktuálně nastavená na původní požadavek, identita se přenese do nového požadavku. 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, před převodem ho nastavte na
nullpůvodní žádost.headersPokud je parametr zadaný, provede se nový požadavek se zadanými hlavičkami. Můžete ho použít ke změně hlaviček požadavků a souborů cookie 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 nastaveným
preserveUsernatrue.
Platí pro
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.
- 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
truezachování identity uživatele; v opačném případě . false Druhá metoda přetížení této metody volá toto přetížení s tímto parametrem nastaveným na true.
Výjimky
Požadavek vyžaduje režim integrovaného kanálu služby IIS 7.0.
Server není k dispozici pro zpracování požadavku.
Parametr path je null.
Parametr path je neplatný.
Poznámky
Další informace naleznete v části Poznámky v TransferRequest(String, Boolean, String, NameValueCollection)části .