HttpServerUtility.TransferRequest Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Réalise une exécution asynchrone de l'URL spécifiée.

Surcharges

TransferRequest(String)	Réalise une exécution asynchrone de l'URL spécifiée.
TransferRequest(String, Boolean)	Exécute une exécution asynchrone de l'URL spécifiée et conserve les paramètres de chaîne de requête.
TransferRequest(String, Boolean, String, NameValueCollection)	Exécute une exécution asynchrone de l'URL spécifiée à l'aide de la méthode et des en-têtes HTTP spécifiés.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Exécute de façon asynchrone l'URL spécifiée à l'aide de la méthode HTTP, des en-têtes et du chemin d'accès spécifiés, et conserve éventuellement les valeurs de formulaire et l'identité de l'utilisateur.

Remarques

TransferRequesta été introduit dans le .NET Framework version 3.5. Pour plus d’informations sur le .NET Framework, consultez Versions et dépendances.

TransferRequest(String)

Réalise une exécution asynchrone de l'URL spécifiée.

public:
 void TransferRequest(System::String ^ path);

public void TransferRequest (string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Paramètres

path

String

Chemin d’accès de l’URL de la nouvelle page sur le serveur à exécuter.

Exceptions

PlatformNotSupportedException

La requête nécessite le mode de pipeline intégré d’IIS 7.0.

HttpException

Le serveur n’est pas disponible pour traiter la demande.

ArgumentNullException

Le paramètre path a la valeur null.

ArgumentException

Le paramètre path n'est pas valide.

Remarques

Cette surcharge de méthode appelle la surcharge avec le TransferRequest preserveForm paramètre défini sur false, le method paramètre défini nullsur , le headers paramètre défini nullsur et le preserveUser paramètre défini sur true. Pour plus d’informations, consultez la section « Remarques » dans TransferRequest(String, Boolean, String, NameValueCollection) la surcharge.

TransferRequest(String, Boolean)

Exécute une exécution asynchrone de l'URL spécifiée et conserve les paramètres de chaîne de requête.

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)

Paramètres

path

String

Chemin d’accès de l’URL de la nouvelle page sur le serveur à exécuter.

preserveForm

Boolean

true pour conserver la collection Form ; false pour effacer la collection Form.

Exceptions

PlatformNotSupportedException

La requête nécessite le mode de pipeline intégré d’IIS 7.0.

HttpException

Le serveur n’est pas disponible pour traiter la demande.

ArgumentNullException

Le paramètre path a la valeur null.

ArgumentException

Le paramètre path n'est pas valide.

Remarques

Cette surcharge appelle la surcharge avec le TransferRequest paramètre défini sur la preserveForm valeur passée, le method paramètre défini nullsur , le headers paramètre défini sur null, le paramètre défini sur , et le preserveUser paramètre défini sur true. Pour plus d’informations, consultez la section « Remarques » dans TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequestest introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

TransferRequest(String, Boolean, String, NameValueCollection)

Exécute une exécution asynchrone de l'URL spécifiée à l'aide de la méthode et des en-têtes HTTP spécifiés.

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)

Paramètres

path

String

Chemin d’accès de l’URL de la nouvelle page sur le serveur à exécuter.

preserveForm

Boolean

true pour conserver la collection Form ; false pour effacer la collection Form.

method

String

La méthode HTTP à utiliser dans l'exécution de la nouvelle requête.

headers

NameValueCollection

Une NameValueCollection d'en-têtes de requête pour la nouvelle requête.

Exceptions

PlatformNotSupportedException

La requête nécessite l’exécution d’IIS 7.0 en mode intégré.

HttpException

Le serveur n’est pas disponible pour traiter la demande.

ArgumentNullException

Le paramètre path a la valeur null.

ArgumentException

Le paramètre path n'est pas valide.

Remarques

Cette méthode est utilisée lors de l’exécution avec le mode de pipeline intégré dans IIS 7.0 pour permettre le transfert du traitement des demandes d’un type de ressource à un autre lors de l’exécution de la requête cible avec le contexte de requête correct. Par exemple, vous pouvez utiliser la TransferRequest méthode pour transférer une demande pour une page ASPX vers une demande pour une page XML.

La TransferRequest méthode effectue une exécution enfant asynchrone de l’URL spécifiée avec les conditions suivantes :

• Si le path paramètre spécifie une chaîne de requête, il sera utilisé comme nouvelle chaîne de requête. Si aucune chaîne de requête n’est incluse, la chaîne de requête de la requête sera réinititidation.

• Si le method paramètre est spécifié, il sera utilisé. Si c’est le cas null, la méthode HTTP de la requête d’origine sera utilisée.

• Si le preserveForm paramètre est true, le corps d’entité actuel de la demande sera disponible pour la requête cible. Cela permet de transférer les billets de formulaire et les chargements.

• Si l’identité de l’utilisateur est actuellement définie sur la demande d’origine, l’identité est transférée à la nouvelle demande. Cela permet aux demandes authentifiées de réutiliser le résultat de l’authentification pour la nouvelle demande. Si vous ne souhaitez pas que l’utilisateur soit transféré, définissez l’utilisateur null sur la demande d’origine avant de le transférer.

• Si le headers paramètre est spécifié, la nouvelle requête s’exécute avec les en-têtes spécifiés. Vous pouvez l’utiliser pour modifier les en-têtes de requête et les cookies pour la nouvelle requête, ou ajouter un en-tête spécial qui spécifie l’emplacement où la demande d’origine a été reçue.

  Cette méthode appelle la surcharge de TransferRequest(String, Boolean, String, NameValueCollection, Boolean) méthode avec le preserveUser paramètre défini truesur .

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Exécute de façon asynchrone l'URL spécifiée à l'aide de la méthode HTTP, des en-têtes et du chemin d'accès spécifiés, et conserve éventuellement les valeurs de formulaire et l'identité de l'utilisateur.

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)

Paramètres

path

String

Chemin d’accès.

preserveForm

Boolean

true pour conserver la collection Form ; false pour effacer la collection Form.

method

String

Méthode HTTP à utiliser dans la nouvelle requête.

headers

NameValueCollection

Objet de NameValueCollection qui contient des en-têtes de requête pour la nouvelle demande.

preserveUser

Boolean

true pour conserver l'identité de l'utilisateur ; sinon, false. Les autres surcharges de méthode de cette méthode appellent cette surcharge avec ce paramètre dont la valeur est true.

Exceptions

PlatformNotSupportedException

La demande nécessite le mode de pipeline intégré d’IIS 7.0.

HttpException

Le serveur n’est pas disponible pour traiter la demande.

ArgumentNullException

Le paramètre path a la valeur null.

ArgumentException

Le paramètre path n'est pas valide.

Remarques

Pour plus d’informations, consultez la section « Notes » dans TransferRequest(String, Boolean, String, NameValueCollection).