Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HttpServerUtility.Transfer méthode (String, Boolean)

 

Date de publication : novembre 2016

Termine l’exécution de la page actuelle et commence celle d’une nouvelle page en utilisant le chemin d’accès de l’URL spécifié pour accéder à la page. Spécifie s’il faut effacer la QueryString et Form collections.

Espace de noms:   System.Web
Assembly:  System.Web (dans System.Web.dll)

public void Transfer(
	string path,
	bool preserveForm
)

Paramètres

path
Type: System.String

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

preserveForm
Type: System.Boolean

true pour conserver les collections QueryString et Form ; false pour effacer les collections QueryString et Form.

Exception Condition
ApplicationException

La demande de page active est un rappel.

La page transférée vers doit être une autre page .aspx. Par exemple, un transfert vers une page .asp ou .asmx n’est pas valide.

Transfer appels End, qui lève une ThreadAbortException exception à l’achèvement.

Si vous définissez la preserveForm paramètre true, la page cible sera en mesure d’accéder à l’état d’affichage de la page précédente en utilisant le PreviousPage propriété.

Pour des raisons de sécurité, vous devez conserver le enableViewStateMac attribut la valeur true. ASP.NET ne vérifie pas que l’utilisateur actuel est autorisé à consulter la ressource fournie par le Transfer (méthode). Bien que la logique d’authentification et d’autorisation ASP.NET s’exécute avant que le Gestionnaire de ressources d’origine est appelé, ASP.NET appelle directement le gestionnaire indiqué par la Transfer méthode et ne réexécute pas la logique d’authentification et d’autorisation pour la nouvelle ressource. Si la stratégie de sécurité de votre application exige des clients une autorisation appropriée pour accéder à la ressource, l’application doit forcer une nouvelle autorisation ou fournir un mécanisme de contrôle d’accès personnalisé.

Vous pouvez forcer une nouvelle autorisation à l’aide de la Redirect méthode plutôt que la Transfer (méthode). Le Redirect méthode exécute une redirection côté client dans laquelle le navigateur demande la nouvelle ressource. Comme cette redirection constitue une nouvelle demande entrant dans le système, il est soumis à toute la logique d’authentification et d’autorisation de la stratégie de sécurité Internet Information Services (IIS) et ASP.NET.

Vous pouvez vérifier que l’utilisateur est autorisé à consulter la ressource en incorporant une méthode d’autorisation personnalisée qui utilise le IsInRole méthode avant l’application appelle la Transfer méthode.

L’exemple suivant exécute une nouvelle page dans le même répertoire que la page actuelle.

Server.Transfer("Logon.aspx", true);

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: