HttpServerUtility.TransferRequest Metoda

Definice

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.

preserveForm
Boolean

true zachovat kolekci Form ; false pro vymazání Form kolekce.

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.

preserveForm
Boolean

true zachovat kolekci Form ; false pro vymazání Form kolekce.

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:

  • 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.

  • preserveForm Pokud je trueparametr, 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 null původní žádost.

  • headers Pokud 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 preserveUser na true.

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.

preserveForm
Boolean

true zachovat kolekci Form ; false pro vymazání Form kolekce.

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 .

Platí pro