HttpServerUtility.TransferRequest Méthode

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

Nom	Description
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 path paramètre est null.

ArgumentException

Le path paramètre n’est pas valide.

Remarques

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

S’applique à

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 Form collection ; false pour effacer la Form collection.

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 path paramètre est null.

ArgumentException

Le path paramètre n’est pas valide.

Remarques

Cette surcharge appelle la surcharge avec le preserveFormTransferRequest paramètre défini sur la valeur passée, le method paramètre défini sur null, le headers paramètre défini sur nullet le preserveUser paramètre 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.

S’applique à

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 Form collection ; false pour effacer la Form collection.

method: String

Méthode HTTP à utiliser dans l’exécution de la nouvelle requête.

headers: NameValueCollection

En-têtes NameValueCollection 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 path paramètre est null.

ArgumentException

Le path paramètre 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 TransferRequest méthode pour transférer une demande de page ASPX vers une demande de 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éutilisée.
Si le method paramètre est spécifié, il sera utilisé. Si c’est nullle cas, 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 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 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 TransferRequest(String, Boolean, String, NameValueCollection, Boolean) surcharge de méthode avec le preserveUser paramètre défini sur true.

S’applique à

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

Le chemin d'accès.

preserveForm: Boolean

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

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 path paramètre est null.

ArgumentException

Le path paramètre n’est pas valide.

Remarques

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?