HttpServerUtility.TransferRequest Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

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 .NET Framework versione 3.5. Per informazioni di riepilogo sulle .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

PlatformNotSupportedException

La richiesta richiede la modalità pipeline integrata di IIS 7.0.

HttpException

Il server non è disponibile per gestire la richiesta.

ArgumentNullException

Il valore del parametro path è null.

ArgumentException

Il parametro path non è valido.

Commenti

Questo metodo esegue l'overload TransferRequest con il preserveForm parametro impostato falsesu , il parametro nullimpostato su , il headers method parametro impostato su e il preserveUser parametro impostato su null``true. Per altre informazioni, vedere la sezione "Osservazioni" nell'overload TransferRequest(String, Boolean, String, NameValueCollection) .

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

PlatformNotSupportedException

La richiesta richiede la modalità pipeline integrata di IIS 7.0.

HttpException

Il server non è disponibile per gestire la richiesta.

ArgumentNullException

Il valore del parametro path è null.

ArgumentException

Il parametro path non è valido.

Commenti

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

TransferRequestviene introdotto nella .NET Framework versione 3.5. Per altre informazioni, vedere Versioni e dipendenze.

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

PlatformNotSupportedException

La richiesta richiede IIS 7.0 in esecuzione in modalità integrata.

HttpException

Il server non è disponibile per gestire la richiesta.

ArgumentNullException

Il valore del parametro path è null.

ArgumentException

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 usare il TransferRequest metodo per trasferire una richiesta per una pagina ASPX a una richiesta per 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 viene specificato il method parametro, verrà usato. Se è null, verrà usato il metodo HTTP della richiesta originale.

• Se il preserveForm parametro è true, il corpo corrente dell'entità della richiesta sarà disponibile per la richiesta di destinazione. Ciò consente il trasferimento di post e caricamenti del modulo.

• Se l'identità utente è attualmente impostata sulla 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 di trasferire.

• Se viene specificato il headers parametro, la nuova richiesta verrà eseguita con le intestazioni specificate. Questa operazione può essere usata per modificare le intestazioni della richiesta e i cookie per la nuova richiesta oppure aggiungere un'intestazione speciale che specifica la posizione in cui è 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.

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

PlatformNotSupportedException

La richiesta richiede la modalità pipeline integrata di IIS 7.0.

HttpException

Il server non è disponibile per gestire la richiesta.

ArgumentNullException

Il valore del parametro path è null.

ArgumentException

Il parametro path non è valido.

Commenti

Per altre informazioni, vedere la sezione "Osservazioni" in TransferRequest(String, Boolean, String, NameValueCollection).