HttpServerUtility.TransferRequest Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esegue un'esecuzione asincrona dell'URL specificato.
Overload
| Nome | Descrizione |
|---|---|
| TransferRequest(String) |
Esegue un'esecuzione asincrona dell'URL specificato. |
| TransferRequest(String, Boolean) |
Esegue un'esecuzione asincrona dell'URL specificato e mantiene i parametri della stringa di query. |
| TransferRequest(String, Boolean, String, NameValueCollection) |
Esegue un'esecuzione asincrona dell'URL specificato usando il metodo HTTP e le intestazioni specificati. |
| TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
Esegue un'esecuzione asincrona dell'URL specificato usando il metodo HTTP, le intestazioni e il percorso specificati e, facoltativamente, mantiene i valori del modulo e l'identità utente. |
Commenti
TransferRequest è stato introdotto in .NET Framework versione 3.5. Per informazioni di riepilogo su .NET Framework, vedere Versions and Dependencies.
TransferRequest(String)
Esegue un'esecuzione asincrona dell'URL specificato.
public:
void TransferRequest(System::String ^ path);
public void TransferRequest(string path);
member this.TransferRequest : string -> unit
Public Sub TransferRequest (path As String)
Parametri
- path
- String
Percorso URL della nuova pagina nel server da eseguire.
Eccezioni
La richiesta richiede la modalità pipeline integrata di IIS 7.0.
Il server non è disponibile per gestire la richiesta.
Il path parametro è null.
Il parametro path non è valido.
Commenti
Questo overload del metodo chiama l'overload TransferRequest con il preserveForm parametro impostato su false, il method parametro impostato su , il headers parametro impostato nullsu nulle il preserveUser parametro impostato su true. Per altre informazioni, vedere la sezione "Osservazioni" nell'overload TransferRequest(String, Boolean, String, NameValueCollection) .
Si applica a
TransferRequest(String, Boolean)
Esegue un'esecuzione asincrona dell'URL specificato e mantiene i parametri della stringa di query.
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)
Parametri
- path
- String
Percorso URL della nuova pagina nel server da eseguire.
Eccezioni
La richiesta richiede la modalità pipeline integrata di IIS 7.0.
Il server non è disponibile per gestire la richiesta.
Il path parametro è null.
Il parametro path non è valido.
Commenti
Questo overload chiama l'overload con il preserveForm parametro impostato sul valore passato, il method parametro impostato su , il headers parametro impostato nullnullsu e il preserveUser parametro impostato su true.TransferRequest Per altre informazioni, vedere la sezione "Osservazioni" in TransferRequest(String, Boolean, String, NameValueCollection).
TransferRequest è stato introdotto in .NET Framework versione 3.5. Per altre informazioni, vedere Versioni e dipendenze.
Si applica a
TransferRequest(String, Boolean, String, NameValueCollection)
Esegue un'esecuzione asincrona dell'URL specificato usando il metodo HTTP e le intestazioni specificati.
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)
Parametri
- path
- String
Percorso URL della nuova pagina nel server da eseguire.
- method
- String
Metodo HTTP da usare nell'esecuzione della nuova richiesta.
- headers
- NameValueCollection
Oggetto NameValueCollection di intestazioni di richiesta per la nuova richiesta.
Eccezioni
La richiesta richiede IIS 7.0 in esecuzione in modalità integrata.
Il server non è disponibile per gestire la richiesta.
Il path parametro è null.
Il parametro path non è valido.
Commenti
Questo metodo viene usato durante l'esecuzione con la modalità pipeline integrata in IIS 7.0 per consentire il trasferimento dell'elaborazione delle richieste da un tipo di risorsa a un altro durante l'esecuzione della richiesta di destinazione con il contesto di richiesta corretto. Ad esempio, è possibile utilizzare il TransferRequest metodo per trasferire una richiesta per una pagina ASPX a una richiesta di una pagina XML.
Il TransferRequest metodo esegue un'esecuzione figlio asincrona dell'URL specificato con le condizioni seguenti:
Se il
pathparametro specifica una stringa di query, verrà usata come nuova stringa di query. Se non è inclusa alcuna stringa di query, la stringa di query della richiesta verrà riutilizzata.Se il
methodparametro viene specificato, verrà usato. Se ènull, verrà usato il metodo HTTP della richiesta originale.Se il
preserveFormparametro ètrue, il corpo dell'entità corrente della richiesta sarà disponibile per la richiesta di destinazione. In questo modo è possibile trasferire i post e i caricamenti dei moduli.Se l'identità utente è attualmente impostata nella richiesta originale, l'identità verrà trasferita alla nuova richiesta. Ciò consente alle richieste autenticate di riutilizzare il risultato dell'autenticazione per la nuova richiesta. Se non si vuole che l'utente venga trasferito, impostare l'utente su
nullsulla richiesta originale prima del trasferimento.Se si specifica il
headersparametro , la nuova richiesta verrà eseguita con le intestazioni specificate. Può essere usato per modificare le intestazioni della richiesta e i cookie per la nuova richiesta oppure aggiungere un'intestazione speciale che specifica dove è stata ricevuta la richiesta originale.Questo metodo chiama l'overload del TransferRequest(String, Boolean, String, NameValueCollection, Boolean) metodo con il
preserveUserparametro impostato sutrue.
Si applica a
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)
Esegue un'esecuzione asincrona dell'URL specificato usando il metodo HTTP, le intestazioni e il percorso specificati e, facoltativamente, mantiene i valori del modulo e l'identità utente.
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)
Parametri
- path
- String
Percorso.
- method
- String
Metodo HTTP da usare nella nuova richiesta.
- headers
- NameValueCollection
Oggetto NameValueCollection che contiene intestazioni di richiesta per la nuova richiesta.
- preserveUser
- Boolean
true per mantenere l'identità dell'utente; in caso contrario, false. Gli altri overload del metodo di questo metodo chiamano questo overload con questo parametro impostato su true.
Eccezioni
La richiesta richiede la modalità pipeline integrata di IIS 7.0.
Il server non è disponibile per gestire la richiesta.
Il path parametro è null.
Il parametro path non è valido.
Commenti
Per altre informazioni, vedere la sezione "Osservazioni" in TransferRequest(String, Boolean, String, NameValueCollection).