HttpServerUtility.TransferRequest Metoda

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

TransferRequest wprowadzono w programie .NET Framework w wersji 3.5. Aby uzyskać podsumowanie informacji na temat programu .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 jest null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

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

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ć kolekcję Form; false, aby wyczyścić kolekcję Form.

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 jest null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

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

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

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ć kolekcję Form; false, aby wyczyścić kolekcję Form.

method

String

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

headers

NameValueCollection

NameValueCollection nagłówków żądań dla nowego żądania.

Wyjątki

PlatformNotSupportedException

Żądanie wymaga, aby usługi IIS 7.0 działały w trybie zintegrowanym.

HttpException

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

ArgumentNullException

Parametr path jest null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

Ta metoda jest używana podczas uruchamiania ze 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. Na przykład można użyć metody TransferRequest do przeniesienia żądania strony ASPX do żądania strony XML.

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

• Jeśli parametr path 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.

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

• Jeśli parametr preserveForm jest true, 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. Umożliwia to uwierzytelnione żądania ponownego użycia wyniku uwierzytelniania dla nowego żądania. Jeśli nie chcesz, aby użytkownik został przeniesiony, przed przeniesieniem ustaw użytkownika na null na oryginalne żądanie.

• Jeśli określono parametr headers, 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 przeciążenie metody TransferRequest(String, Boolean, String, NameValueCollection, Boolean) z parametrem preserveUser ustawionym na true.

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ć kolekcję Form; false, aby wyczyścić kolekcję Form.

method

String

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

headers

NameValueCollection

Obiekt NameValueCollection zawierający nagłówki żądań dla nowego żądania.

preserveUser

Boolean

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

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 jest null.

ArgumentException

Parametr path jest nieprawidłowy.

Uwagi

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