HttpServerUtility.TransferRequest Metodo

Definizione

Esegue un'esecuzione asincrona dell'URL specificato.

Overload

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 e le intestazioni HTTP 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 form e l'identità dell'utente.

Commenti

TransferRequest è stato introdotto nella versione .NET Framework 3,5. Per informazioni di riepilogo sul .NET Framework, vedere versioni e dipendenze.

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 sul server da eseguire.

Eccezioni

Per la richiesta è necessaria la modalità pipeline integrata di IIS 7,0.

Il server non è disponibile per gestire la richiesta.

Il valore del parametro path è null.

Il parametro path non è valido.

Commenti

Questo overload del metodo chiama l' TransferRequest Overload con il preserveForm parametro impostato su false , il method parametro impostato su null , il headers parametro impostato su null e il preserveUser parametro impostato su true . Per ulteriori informazioni, vedere la sezione "osservazioni" in TransferRequest(String, Boolean, String, NameValueCollection) Overload.

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 sul server da eseguire.

preserveForm
Boolean

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

Eccezioni

Per la richiesta è necessaria la modalità pipeline integrata di IIS 7,0.

Il server non è disponibile per gestire la richiesta.

Il valore del parametro path è null.

Il parametro path non è valido.

Commenti

Questo overload chiama l' TransferRequest Overload con il preserveForm parametro impostato sul valore passato, il method parametro impostato su null , il headers parametro impostato su null e il preserveUser parametro impostato su true . Per ulteriori informazioni, vedere la sezione "osservazioni" in TransferRequest(String, Boolean, String, NameValueCollection) .

TransferRequest è stato introdotto nella versione .NET Framework 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 e le intestazioni HTTP 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 sul server da eseguire.

preserveForm
Boolean

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

method
String

Metodo HTTP da usare nell'esecuzione della nuova richiesta.

headers
NameValueCollection

NameValueCollection di intestazioni delle richieste per la nuova richiesta.

Eccezioni

Per la richiesta è necessario che IIS 7,0 sia in esecuzione in modalità integrata.

Il server non è disponibile per gestire la richiesta.

Il valore del parametro path è null.

Il parametro path non è valido.

Commenti

Questo metodo viene usato quando si esegue 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 della richiesta corretto. È ad esempio possibile utilizzare il TransferRequest metodo per trasferire una richiesta di una pagina aspx a una richiesta di una pagina XML.

Il TransferRequest metodo esegue un'esecuzione asincrona dell'URL specificato con le condizioni seguenti:

  • Se il path parametro specifica una stringa di query, verrà usato come nuova stringa di query. Se non è inclusa alcuna stringa di query, la stringa di query della richiesta verrà riutilizzata.

  • Se il method parametro è specificato, verrà usato. In tal caso null , verrà utilizzato 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 del modulo.

  • 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 desidera che l'utente venga trasferito, impostare l'utente null sulla richiesta originale prima del trasferimento.

  • Se headers viene specificato il parametro, la nuova richiesta verrà eseguita con le intestazioni specificate. Questa operazione può essere utilizzata per modificare le intestazioni della richiesta e i cookie per la nuova richiesta oppure aggiungere un'intestazione speciale che specifichi la posizione in cui è stata ricevuta la richiesta originale.

    Questo metodo chiama l' TransferRequest(String, Boolean, String, NameValueCollection, Boolean) Overload del 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 form e l'identità dell'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 conservare la raccolta Form; false per cancellare la raccolta Form.

method
String

Metodo HTTP da usare nella nuova richiesta.

headers
NameValueCollection

Oggetto NameValueCollection che contiene le intestazioni di richiesta per le nuove richieste.

preserveUser
Boolean

true per mantenere l'identità dell'utente; in caso contrario, false. Gli altri overload di questo metodo chiamano questo overload con il parametro impostato su true.

Eccezioni

Per la richiesta è necessaria la modalità pipeline integrata di IIS 7,0.

Il server non è disponibile per gestire la richiesta.

Il valore del parametro path è null.

Il parametro path non è valido.

Commenti

Per ulteriori informazioni, vedere la sezione "osservazioni" in TransferRequest(String, Boolean, String, NameValueCollection) .

Si applica a