HttpServerUtility.Execute 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 le gestionnaire d’une ressource spécifiée dans le contexte de la requête actuelle et retourne l’exécution à la page qui l’a appelée.

Surcharges

Nom	Description
Execute(String)	Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle.
Execute(String, Boolean)	Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle et spécifie s’il faut effacer les collections et Form les QueryString supprimer.
Execute(String, TextWriter)	Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture la sortie du gestionnaire exécuté.
Execute(String, TextWriter, Boolean)	Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture de sortie de la page et d’un paramètre booléen spécifie s’il faut effacer les collections et Form les QueryString collections.
Execute(IHttpHandler, TextWriter, Boolean)	Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture la sortie du gestionnaire exécuté et d’un paramètre booléen spécifie s’il faut effacer les collections et Form les QueryString supprimer.

Execute(String)

Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle.

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

public void Execute(string path);

member this.Execute : string -> unit

Public Sub Execute (path As String)

Paramètres

path: String

Chemin d’url à exécuter.

Exceptions

HttpException

Le courant HttpContext est null.

-ou-

Une erreur s’est produite lors de l’exécution du gestionnaire spécifié par path.

ArgumentNullException

path a la valeur null.

-ou-

path n’est pas un chemin d’accès virtuel.

Exemples

L’exemple suivant affiche la page .aspx « Updateinfo.aspx » dans le répertoire actif. L’exécution du programme retourne à la page de démarrage une fois la page Updateinfo.aspx affichée.

Server.Execute("updateinfo.aspx");

Server.Execute("updateinfo.aspx")

Remarques

La Execute méthode poursuit l’exécution de la page d’origine après l’exécution de la nouvelle page. La méthode transfère inconditionnellement l’exécution Transfer à un autre gestionnaire.

ASP.NET ne vérifie pas que l’utilisateur actuel est autorisé à afficher la ressource fournie par la Execute méthode. Bien que la logique d’autorisation et d’authentification ASP.NET s’exécute avant l’appel du gestionnaire de ressources d’origine, ASP.NET appelle directement le gestionnaire indiqué par la méthode et ne réexécute pas l’authentification Execute et la logique d’autorisation pour la nouvelle ressource. Si la stratégie de sécurité de votre application exige que les clients disposent d’une autorisation appropriée pour accéder à la ressource, l’application doit forcer la réauthorisation ou fournir un mécanisme de contrôle d’accès personnalisé.

Vous pouvez forcer la réauthorisation à l’aide de la Redirect méthode au lieu de la Execute méthode. Redirect effectue une redirection côté client dans laquelle le navigateur demande la nouvelle ressource. Étant donné que cette redirection est une nouvelle requête entrant dans le système, elle est soumise à toutes les logiques d’authentification et d’autorisation des services Internet Information Services (IIS) et ASP.NET stratégie de sécurité.

Vous pouvez vérifier que l’utilisateur a l’autorisation d’afficher la ressource en incorporant une méthode d’autorisation personnalisée qui utilise la IsInRole méthode avant que l’application appelle la Execute méthode.

S’applique à

Execute(String, Boolean)

Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle et spécifie s’il faut effacer les collections et Form les QueryString supprimer.

public:
 void Execute(System::String ^ path, bool preserveForm);

public void Execute(string path, bool preserveForm);

member this.Execute : string * bool -> unit

Public Sub Execute (path As String, preserveForm As Boolean)

Paramètres

path: String

Chemin d’url à exécuter.

preserveForm: Boolean

truepour conserver les QueryString collections ; Formfalse pour effacer les collections et QueryString les Form collections.

Exceptions

HttpException

Le courant HttpContext est null.

-ou-

Une erreur s’est produite lors de l’exécution du gestionnaire spécifié par path.

ArgumentNullException

path a la valeur null.

-ou-

path n’est pas un chemin d’accès virtuel.

Exemples

L’exemple suivant montre comment exécuter la page Updateinfo.aspx .aspx dans la requête actuelle et conserver les collections et Form les QueryString collections. L’exécution du programme retourne à la page de démarrage une fois Updateinfo.aspx affichée.

private void Page_Load(Object sender, EventArgs e)
{
    Server.Execute("updateinfo.aspx", true);
}

Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    Server.Execute("updateinfo.aspx", True)
End Sub

Voir aussi

Transfer

S’applique à

Execute(String, TextWriter)

Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture la sortie du gestionnaire exécuté.

public:
 void Execute(System::String ^ path, System::IO::TextWriter ^ writer);

public void Execute(string path, System.IO.TextWriter writer);

member this.Execute : string * System.IO.TextWriter -> unit

Public Sub Execute (path As String, writer As TextWriter)

Paramètres

path: String

Chemin d’url à exécuter.

writer: TextWriter

Pour TextWriter capturer la sortie.

Exceptions

HttpException

Le courant HttpContext est null.

-ou-

Une erreur s’est produite lors de l’exécution du gestionnaire spécifié par path.

ArgumentNullException

path a la valeur null.

-ou-

path n’est pas un chemin d’accès virtuel.

Exemples

L’exemple suivant exécute la Login.aspx page sur le serveur dans le répertoire actif et reçoit la sortie de la page via l’objet writerStringWriter . Il écrit le flux HTML reçu writer dans le flux de sortie HTTP.

StringWriter writer = new StringWriter();
Server.Execute("Login.aspx", writer);
Response.Write("<H3>Please Login:</H3><br>"+ writer.ToString());

Dim writer As New StringWriter
Server.Execute("Login.aspx", writer)
Response.Write("<H3>Please Login:</H3><br>" & writer.ToString())

Remarques

La Execute méthode poursuit l’exécution de la requête d’origine après l’exécution du chemin d’accès virtuel spécifié. La méthode transfère inconditionnellement l’exécution Transfer à un autre gestionnaire.

Voir aussi

Transfer

S’applique à

Execute(String, TextWriter, Boolean)

Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture de sortie de la page et d’un paramètre booléen spécifie s’il faut effacer les collections et Form les QueryString collections.

public:
 void Execute(System::String ^ path, System::IO::TextWriter ^ writer, bool preserveForm);

public void Execute(string path, System.IO.TextWriter writer, bool preserveForm);

member this.Execute : string * System.IO.TextWriter * bool -> unit

Public Sub Execute (path As String, writer As TextWriter, preserveForm As Boolean)

Paramètres

path: String

Chemin d’url à exécuter.

writer: TextWriter

Pour TextWriter capturer la sortie.

preserveForm: Boolean

truepour conserver les QueryString collections ; Formfalse pour effacer les collections et QueryString les Form collections.

Exceptions

HttpException

Le HttpContext actuel est une référence Null (Nothing dans Visual Basic).

-ou-

path se termine par un point (.).

-ou-

Une erreur s’est produite lors de l’exécution du gestionnaire spécifié par path.

ArgumentNullException

path a la valeur null.

ArgumentException

path n’est pas un chemin d’accès virtuel.

Exemples

private void Page_Load(Object sender, EventArgs e)
{
    System.IO.StringWriter writer = new System.IO.StringWriter();
    Server.Execute("Login.aspx", writer, true);
    Response.Write("<h3>Please Login:</h3><br />" + writer.ToString());
}

Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    Dim writer As System.IO.StringWriter = New System.IO.StringWriter()
    Server.Execute("Login.aspx", writer, True)
    Response.Write("<h3>Please Login:</h3><br />" + writer.ToString())
End Sub

Remarques

La Execute méthode poursuit l’exécution de la requête d’origine après l’exécution du chemin virtuel spécifié. La méthode transfère inconditionnellement l’exécution Transfer à un autre gestionnaire.

Voir aussi

Transfer

S’applique à

Execute(IHttpHandler, TextWriter, Boolean)

Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture la sortie du gestionnaire exécuté et d’un paramètre booléen spécifie s’il faut effacer les collections et Form les QueryString supprimer.

public:
 void Execute(System::Web::IHttpHandler ^ handler, System::IO::TextWriter ^ writer, bool preserveForm);

public void Execute(System.Web.IHttpHandler handler, System.IO.TextWriter writer, bool preserveForm);

member this.Execute : System.Web.IHttpHandler * System.IO.TextWriter * bool -> unit

Public Sub Execute (handler As IHttpHandler, writer As TextWriter, preserveForm As Boolean)

Paramètres

handler: IHttpHandler

Gestionnaire HTTP vers lequel implémente IHttpHandler la requête actuelle.

writer: TextWriter

Pour TextWriter capturer la sortie.

preserveForm: Boolean

truepour conserver les QueryString collections ; Formfalse pour effacer les collections et QueryString les Form collections.

Exceptions

HttpException

Une erreur s’est produite lors de l’exécution du gestionnaire spécifié par handler.

ArgumentNullException

Le handler paramètre est null.

Remarques

Vous pouvez écrire des gestionnaires HTTP personnalisés pour traiter des types spécifiques et prédéfinis de requêtes HTTP dans n’importe quel langage conforme à la spécification CLS (Common Language Specification). Le code exécutable défini dans les classes de gestionnaire HTTP au lieu de pages ASP conventionnelles (également appelées ASP classiques) ou ASP.NET pages répond à ces requêtes spécifiques. Les gestionnaires HTTP permettent d’interagir avec les services de requête et de réponse de bas niveau d’un serveur Web exécutant Internet Information Services (IIS), et ils fournissent des fonctionnalités similaires aux extensions ISAPI, mais avec un modèle de programmation plus simple.

ASP.NET ne vérifie pas que l’utilisateur actuel est autorisé à afficher la ressource fournie par la méthode Execute. Bien que la logique d’autorisation et d’authentification ASP.NET s’exécute avant l’appel du gestionnaire de ressources d’origine, ASP.NET appelle directement le gestionnaire indiqué par la méthode Execute et n’exécute pas de logique d’authentification et d’autorisation pour la nouvelle ressource. Si la stratégie de sécurité de votre application exige que les clients disposent d’une autorisation appropriée pour accéder à la ressource, l’application doit forcer la réauthorisation ou fournir un mécanisme de contrôle d’accès personnalisé.

Vous pouvez forcer la réauthorisation à l’aide de la Redirect méthode au lieu de la Execute méthode. Effectue Redirect une redirection côté client dans laquelle le navigateur demande la nouvelle ressource. Étant donné que cette redirection est une nouvelle requête entrant dans le système, elle est soumise à toutes les logiques d’authentification et d’autorisation des stratégies de sécurité IIS et ASP.NET.

Voir aussi

Transfer

S’applique à

Commentaires

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