HttpServerUtility.TransferRequest Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Żądanie wymaga zintegrowanego trybu potoku usług IIS 7.0.
Serwer nie jest dostępny do obsługi żądania.
Parametr path
to null
.
Parametr path
jest nieprawidłowy.
Uwagi
To przeciążenie metody wywołuje TransferRequest przeciążenie z parametrem ustawionym preserveForm
na false
, method
parametr ustawiony null
na , 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.
Wyjątki
Żądanie wymaga zintegrowanego trybu potoku usług IIS 7.0.
Serwer nie jest dostępny do obsługi żądania.
Parametr path
to null
.
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.
- method
- String
Metoda HTTP do użycia w wykonaniu nowego żądania.
- headers
- NameValueCollection
Nagłówek NameValueCollection żądania dla nowego żądania.
Wyjątki
Żądanie wymaga usług IIS 7.0 uruchomionych w trybie zintegrowanym.
Serwer nie jest dostępny do obsługi żądania.
Parametr path
ma wartość null
.
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 jestnull
to , zostanie użyta metoda HTTP oryginalnego żądania.preserveForm
Jeśli parametr matrue
wartość , 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
natrue
.
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.
- 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 true
wartość .
Wyjątki
Żądanie wymaga zintegrowanego trybu potoku usług IIS 7.0.
Serwer nie jest dostępny do obsługi żądania.
Parametr path
ma wartość null
.
Parametr path
jest nieprawidłowy.
Uwagi
Aby uzyskać więcej informacji, zobacz sekcję "Uwagi" w temacie TransferRequest(String, Boolean, String, NameValueCollection).