HttpServerUtility.TransferRequest Metodo

Definizione

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.

preserveForm
Boolean

true per mantenere la Form raccolta; false per cancellare la Form raccolta.

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.

preserveForm
Boolean

true per mantenere la Form raccolta; false per cancellare la Form raccolta.

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 path parametro 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 method parametro viene specificato, verrà usato. Se è null, verrà usato il metodo HTTP della richiesta originale.

  • Se il preserveForm parametro è 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 null sulla richiesta originale prima del trasferimento.

  • Se si specifica il headers parametro , 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 preserveUser parametro impostato su true.

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.

preserveForm
Boolean

true per mantenere la Form raccolta; false per cancellare la Form raccolta.

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

Si applica a