HttpServerUtility.TransferRequest Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Exécute une exécution asynchrone de l’URL spécifiée.

Surcharges

TransferRequest(String)	Exécute 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 HTTP et des en-têtes spécifiés.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Effectue une exécution asynchrone de 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

TransferRequest a été introduit dans .NET Framework version 3.5. Pour plus d’informations sur .NET Framework, consultez versions et dépendances.

TransferRequest(String)

Exécute 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’URL de la nouvelle page sur le serveur à exécuter.

Exceptions

PlatformNotSupportedException

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

HttpException

Le serveur n’est pas disponible pour gérer la requête.

ArgumentNullException

Le paramètre path est null.

ArgumentException

Le paramètre path n’est pas valide.

Remarques

Cette surcharge de méthode appelle la surcharge TransferRequest avec le paramètre preserveForm défini sur false, le paramètre method défini sur null, le paramètre headers défini sur nullet le paramètre preserveUser défini sur true. Pour plus d’informations, consultez la section « Remarques » dans TransferRequest(String, Boolean, String, NameValueCollection) 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’URL de la nouvelle page sur le serveur à exécuter.

preserveForm

Boolean

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

Exceptions

PlatformNotSupportedException

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

HttpException

Le serveur n’est pas disponible pour gérer la requête.

ArgumentNullException

Le paramètre path est null.

ArgumentException

Le paramètre path n’est pas valide.

Remarques

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

TransferRequest est introduit dans .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 HTTP et des en-têtes 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’URL de la nouvelle page sur le serveur à exécuter.

preserveForm

Boolean

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

method

String

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 demande nécessite IIS 7.0 s’exécutant en mode intégré.

HttpException

Le serveur n’est pas disponible pour gérer la requête.

ArgumentNullException

Le paramètre path est 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 demande cible avec le contexte de requête correct. Par exemple, vous pouvez utiliser la méthode TransferRequest pour transférer une demande de page ASPX vers une demande de page XML.

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

• Si le paramètre path 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éutilisée.

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

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

• Si l’identité de l’utilisateur est actuellement définie sur la demande d’origine, l’identité est transférée vers 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 sur null sur la demande d’origine avant de le transférer.

• Si le paramètre headers 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 méthode TransferRequest(String, Boolean, String, NameValueCollection, Boolean) avec le paramètre preserveUser défini sur true.

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

Effectue une exécution asynchrone de 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 de Form ; false pour effacer la collection Form.

method

String

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

headers

NameValueCollection

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

preserveUser

Boolean

true pour préserver l’identité de l’utilisateur ; sinon, false. Les autres surcharges de méthode de cette méthode appellent cette surcharge avec ce paramètre défini sur 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 gérer la requête.

ArgumentNullException

Le paramètre path est null.

ArgumentException

Le paramètre path n’est pas valide.

Remarques

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