Udostępnij za pośrednictwem

HttpServerUtility.TransferRequest Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web
Zestaw:
System.Web.dll

Wykonuje asynchroniczne wykonywanie określonego adresu URL.

Przeciążenia

TransferRequest(String)

Wykonuje asynchroniczne wykonywanie określonego adresu URL.
TransferRequest(String, Boolean)

Wykonuje asynchroniczne wykonywanie określonego adresu URL i zachowuje parametry ciągu zapytania.
TransferRequest(String, Boolean, String, NameValueCollection)

Wykonuje asynchroniczne wykonywanie określonego adresu URL przy użyciu określonej metody HTTP i nagłówków.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Wykonuje asynchroniczne wykonywanie określonego adresu URL przy użyciu określonej metody HTTP, nagłówków i ścieżki, a opcjonalnie zachowuje wartości formularza i tożsamość użytkownika.

Uwagi

TransferRequestwprowadzono w .NET Framework w wersji 3.5. Aby uzyskać podsumowanie informacji na temat .NET Framework, zobacz Wersje i zależności.

TransferRequest(String)

Wykonuje asynchroniczne wykonywanie określonego adresu 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

Ścieżka adresu URL nowej strony na serwerze do wykonania.

Wyjątki

PlatformNotSupportedException

Żądanie wymaga zintegrowanego trybu potoku usług IIS 7.0.

HttpException

Serwer nie jest dostępny do obsługi żądania.

ArgumentNullException

Parametr path to null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

To przeciążenie metody wywołuje TransferRequest przeciążenie z parametrem ustawionym preserveForm na false, method parametr ustawiony nullna , headers parametr ustawiony na null, i preserveUser parametr ustawiony na true. Aby uzyskać więcej informacji, zobacz sekcję "Uwagi" w TransferRequest(String, Boolean, String, NameValueCollection) przeciążeniu.

Dotyczy

TransferRequest(String, Boolean)

Wykonuje asynchroniczne wykonywanie określonego adresu URL i zachowuje parametry ciągu zapytania.

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

Ścieżka adresu URL nowej strony na serwerze do wykonania.

preserveForm
Boolean

true aby zachować Form kolekcję; false aby wyczyścić Form kolekcję.

Wyjątki

PlatformNotSupportedException

Żądanie wymaga zintegrowanego trybu potoku usług IIS 7.0.

HttpException

Serwer nie jest dostępny do obsługi żądania.

ArgumentNullException

Parametr path to null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

To przeciążenie wywołuje TransferRequest przeciążenie z parametrem preserveForm ustawionym na wartość przekazaną, method parametr ustawiony na , headers parametr ustawiony na null``null, i preserveUser parametr ustawiony na true. Aby uzyskać więcej informacji, zobacz sekcję "Uwagi" w temacie TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequestjest wprowadzana w wersji .NET Framework 3.5. Aby uzyskać więcej informacji, zobacz Wersje i zależności.

Dotyczy

TransferRequest(String, Boolean, String, NameValueCollection)

Wykonuje asynchroniczne wykonywanie określonego adresu URL przy użyciu określonej metody HTTP i nagłówków.

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

Ścieżka adresu URL nowej strony na serwerze do wykonania.

preserveForm
Boolean

true aby zachować Form kolekcję; false aby wyczyścić Form kolekcję.

method
String

Metoda HTTP do użycia w wykonaniu nowego żądania.

headers
NameValueCollection

Nagłówek NameValueCollection żądania dla nowego żądania.

Wyjątki

PlatformNotSupportedException

Żądanie wymaga usług IIS 7.0 uruchomionych w trybie zintegrowanym.

HttpException

Serwer nie jest dostępny do obsługi żądania.

ArgumentNullException

Parametr path ma wartość null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

Ta metoda jest używana podczas uruchamiania z zintegrowanym trybem potoku w usługach IIS 7.0, aby umożliwić przesyłanie przetwarzania żądań z jednego typu zasobu do innego podczas wykonywania żądania docelowego z poprawnym kontekstem żądania. Można na przykład użyć TransferRequest metody , aby przenieść żądanie dla strony ASPX do żądania dla strony XML.

Metoda TransferRequest wykonuje asynchroniczne wykonanie określonego adresu URL z następującymi warunkami:

  • path Jeśli parametr określa ciąg zapytania, będzie on używany jako nowy ciąg zapytania. Jeśli ciąg zapytania nie zostanie uwzględniony, zostanie ponownie użyty ciąg zapytania żądania.

  • method Jeśli parametr zostanie określony, zostanie użyty. Jeśli jest nullto , zostanie użyta metoda HTTP oryginalnego żądania.

  • preserveForm Jeśli parametr ma truewartość , bieżąca treść jednostki żądania będzie dostępna dla żądania docelowego. Umożliwia to przesyłanie wpisów i przekazywania formularzy.

  • Jeśli tożsamość użytkownika jest obecnie ustawiona na oryginalne żądanie, tożsamość zostanie przeniesiona do nowego żądania. Dzięki temu uwierzytelnione żądania mogą ponownie używać wyniku uwierzytelniania dla nowego żądania. Jeśli nie chcesz, aby użytkownik został przeniesiony, przed przeniesieniem ustaw dla użytkownika null wartość na oryginalne żądanie.

  • headers Jeśli parametr zostanie określony, nowe żądanie zostanie wykonane z określonymi nagłówkami. Może to służyć do modyfikowania nagłówków żądań i plików cookie dla nowego żądania lub dodania specjalnego nagłówka określającego miejsce odebrania oryginalnego żądania.

    Ta metoda wywołuje TransferRequest(String, Boolean, String, NameValueCollection, Boolean) przeciążenie metody z parametrem ustawionym preserveUser na true.

Dotyczy

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

Wykonuje asynchroniczne wykonywanie określonego adresu URL przy użyciu określonej metody HTTP, nagłówków i ścieżki, a opcjonalnie zachowuje wartości formularza i tożsamość użytkownika.

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

Ścieżka.

preserveForm
Boolean

true aby zachować Form kolekcję, false aby wyczyścić Form kolekcję.

method
String

Metoda HTTP do użycia w nowym żądaniu.

headers
NameValueCollection

NameValueCollection Obiekt, który zawiera nagłówki żądań dla nowego żądania.

preserveUser
Boolean

true aby zachować tożsamość użytkownika; w przeciwnym razie , false. Inne przeciążenia tej metody wywołają to przeciążenie z tym parametrem ustawionym na truewartość .

Wyjątki

PlatformNotSupportedException

Żądanie wymaga zintegrowanego trybu potoku usług IIS 7.0.

HttpException

Serwer nie jest dostępny do obsługi żądania.

ArgumentNullException

Parametr path ma wartość null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

Aby uzyskać więcej informacji, zobacz sekcję "Uwagi" w temacie TransferRequest(String, Boolean, String, NameValueCollection).

Dotyczy