HttpServerUtility.Execute Méthode

Référence

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, puis retourne l'exécution à la page qui l'a appelée.

Surcharges

Execute(String)	Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle.
Execute(String, Boolean)	Exécute le gestionnaire du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle, et spécifie s'il faut ou non effacer les collections QueryString et Form.
Execute(String, TextWriter)	Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. TextWriter intercepte la sortie du gestionnaire exécuté.
Execute(String, TextWriter, Boolean)	Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Un TextWriter intercepte la sortie de la page, et un paramètre Boolean spécifie s'il faut ou non effacer les collections QueryString et Form.
Execute(IHttpHandler, TextWriter, Boolean)	Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Un TextWriter intercepte la sortie du gestionnaire exécuté, et un paramètre Boolean spécifie s'il faut ou non effacer les collections QueryString et Form.

Execute(String)

Exécute le gestionnaire du 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'accès d'URL à exécuter.

Exceptions

HttpException

Le HttpContext actuel a la valeur 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 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 continue l’exécution de la page d’origine après l’exécution de la nouvelle page. La Transfer méthode transfère inconditionnellement l’exécution à 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 et la Execute logique d’autorisation pour la nouvelle ressource. Si la stratégie de sécurité de votre application nécessite 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 demande entrante dans le système, elle est soumise à toutes les logiques d’authentification et d’autorisation des deux Internet Information Services (IIS) et ASP.NET stratégie de sécurité.

Vous pouvez vérifier que l’utilisateur dispose de l’autorisation d’afficher la ressource en intégrant 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 du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle, et spécifie s'il faut ou non effacer les collections QueryString et Form.

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'accès d'URL à exécuter.

preserveForm: Boolean

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

Exceptions

HttpException

Le HttpContext actuel a la valeur 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 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 du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. TextWriter intercepte 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'accès d'URL à exécuter.

writer: TextWriter

TextWriter à utiliser pour capturer la sortie.

Exceptions

HttpException

Le HttpContext actuel a la valeur 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 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’objetwriterStringWriter. Il écrit le flux HTML reçu dans le flux de writer 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 virtuel spécifié. La Transfer méthode transfère inconditionnellement l’exécution à un autre gestionnaire.

Voir aussi

Transfer

S’applique à

Execute(String, TextWriter, Boolean)

Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Un TextWriter intercepte la sortie de la page, et un paramètre Boolean spécifie s'il faut ou non effacer les collections QueryString et Form.

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'accès d'URL à exécuter.

writer: TextWriter

TextWriter à utiliser pour capturer la sortie.

preserveForm: Boolean

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

Exceptions

HttpException

Le HttpContext actuel est une référence null (Nothing en 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 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 continue l’exécution de la requête d’origine après l’exécution du chemin virtuel spécifié. La Transfer méthode transfère inconditionnellement l’exécution à un autre gestionnaire.

Voir aussi

Transfer

S’applique à

Execute(IHttpHandler, TextWriter, Boolean)

Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Un TextWriter intercepte la sortie du gestionnaire exécuté, et un paramètre Boolean spécifie s'il faut ou non effacer les collections QueryString et Form.

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

Le gestionnaire HTTP qui implémente le IHttpHandler auquel transférer la requête actuelle.

writer: TextWriter

TextWriter à utiliser pour capturer la sortie.

preserveForm: Boolean

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

Exceptions

HttpException

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

ArgumentNullException

Le paramètre handler a la valeur 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 classiques (é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 qui exécute Internet Information Services (IIS) et fournissent des fonctionnalités similaires aux extensions ISAPI, mais avec un modèle de programmation plus simple.

Vous pouvez forcer la réauthorisation à l’aide de la Redirect méthode au lieu de la Execute méthode. Il Redirect effectue une redirection côté client dans laquelle le navigateur demande la nouvelle ressource. Étant donné que cette redirection est une nouvelle demande entrante 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 à

HttpServerUtility.Execute Méthode

Définition

Surcharges

Execute(String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Execute(String, Boolean)

Paramètres

Exceptions

Exemples

Voir aussi

S’applique à

Execute(String, TextWriter)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Execute(String, TextWriter, Boolean)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Execute(IHttpHandler, TextWriter, Boolean)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Ressources supplémentaires