HttpServerUtility.Execute Methode

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Führt den Handler für eine angegebene Ressource im Kontext der aktuellen Anforderung aus und gibt die Ausführung an die Seite zurück, die sie aufgerufen hat.

Überlädt

Name	Beschreibung
Execute(String)	Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus.
Execute(String, Boolean)	Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus und gibt an, ob die QueryString Auflistungen gelöscht werden Form sollen.
Execute(String, TextWriter)	Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Eine TextWriter Erfassung der Ausgabe des ausgeführten Handlers.
Execute(String, TextWriter, Boolean)	Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Eine TextWriter Erfassung der Ausgabe von der Seite und ein boolescher Parameter gibt an, ob die QueryString Auflistungen gelöscht werden Form sollen.
Execute(IHttpHandler, TextWriter, Boolean)	Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Eine TextWriter Erfassung der Ausgabe des ausgeführten Handlers und eines booleschen Parameters gibt an, ob die QueryString Auflistungen gelöscht werden Form sollen.

Execute(String)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus.

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

public void Execute(string path);

member this.Execute : string -> unit

Public Sub Execute (path As String)

Parameter

path: String

Der auszuführende URL-Pfad.

Ausnahmen

HttpException

Die aktuelle HttpContext ist null.

-oder-

Fehler beim Ausführen des durch path.

ArgumentNullException

path ist null.

-oder-

path ist kein virtueller Pfad.

Beispiele

Im folgenden Beispiel wird die .aspx Seite "Updateinfo.aspx" im aktuellen Verzeichnis angezeigt. Die Programmausführung kehrt zur Startseite zurück, nachdem die Updateinfo.aspx Seite angezeigt wurde.

Server.Execute("updateinfo.aspx");

Server.Execute("updateinfo.aspx")

Hinweise

Die Execute Methode setzt die Ausführung der ursprünglichen Seite fort, nachdem die Ausführung der neuen Seite abgeschlossen wurde. Die Transfer Methode überträgt die Ausführung bedingungslos an einen anderen Handler.

ASP.NET überprüft nicht, ob der aktuelle Benutzer berechtigt ist, die von der Execute Methode bereitgestellte Ressource anzuzeigen. Obwohl die ASP.NET Autorisierungs- und Authentifizierungslogik ausgeführt wird, bevor der ursprüngliche Ressourcenhandler aufgerufen wird, ruft ASP.NET den von der Execute Methode angegebenen Handler direkt auf und führt die Authentifizierungs- und Autorisierungslogik für die neue Ressource nicht erneut aus. Wenn für die Sicherheitsrichtlinie Ihrer Anwendung Clients eine entsprechende Autorisierung für den Zugriff auf die Ressource erforderlich sind, sollte die Anwendung die erneute Dokumenterstellung erzwingen oder einen benutzerdefinierten Zugriffssteuerungsmechanismus bereitstellen.

Sie können die erneute Dokumenterstellung erzwingen, indem Sie die Redirect Methode anstelle der Execute Methode verwenden. Redirect führt eine clientseitige Umleitung aus, in der der Browser die neue Ressource anfordert. Da es sich bei dieser Umleitung um eine neue Anforderung handelt, die das System eingibt, unterliegt sie allen Authentifizierungs- und Autorisierungslogiken sowohl von Internetinformationsdienste (IIS) als auch ASP.NET Sicherheitsrichtlinie.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine benutzerdefinierte Autorisierungsmethode integrieren, die die IsInRole Methode verwendet, bevor die Anwendung die Execute Methode aufruft.

Gilt für:

Execute(String, Boolean)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus und gibt an, ob die QueryString Auflistungen gelöscht werden Form sollen.

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)

Parameter

path: String

Der auszuführende URL-Pfad.

preserveForm: Boolean

trueum die Auflistungen QueryString und die Sammlungen zu erhalten, Form um die falseQueryString Auflistungen Form zu löschen.

Ausnahmen

HttpException

Die aktuelle HttpContext ist null.

-oder-

Fehler beim Ausführen des durch path.

ArgumentNullException

path ist null.

-oder-

path ist kein virtueller Pfad.

Beispiele

Das folgende Beispiel zeigt, wie sie die .aspx-Seite Updateinfo.aspx in der aktuellen Anforderung ausführen und die QueryString Auflistungen Form beibehalten. Die Programmausführung kehrt zur Startseite zurück, nachdem Updateinfo.aspx sie angezeigt wurde.

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

Weitere Informationen

Transfer

Gilt für:

Execute(String, TextWriter)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Eine TextWriter Erfassung der Ausgabe des ausgeführten Handlers.

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)

Parameter

path: String

Der auszuführende URL-Pfad.

writer: TextWriter

The TextWriter to capture the output.

Ausnahmen

HttpException

Die aktuelle HttpContext ist null.

-oder-

Fehler beim Ausführen des durch path.

ArgumentNullException

path ist null.

-oder-

path ist kein virtueller Pfad.

Beispiele

Im folgenden Beispiel wird die Login.aspx Seite auf dem Server im aktuellen Verzeichnis ausgeführt und die Ausgabe von der Seite über das StringWriter Objekt writerempfangen. Er schreibt den HTML-Stream, der vom writer HTTP-Ausgabedatenstrom empfangen wird.

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())

Hinweise

Die Execute Methode setzt die Ausführung der ursprünglichen Anforderung fort, nachdem die Ausführung des angegebenen virtuellen Pfads abgeschlossen wurde. Die Transfer Methode überträgt die Ausführung bedingungslos an einen anderen Handler.

Weitere Informationen

Transfer

Gilt für:

Execute(String, TextWriter, Boolean)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Eine TextWriter Erfassung der Ausgabe von der Seite und ein boolescher Parameter gibt an, ob die QueryString Auflistungen gelöscht werden Form sollen.

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)

Parameter

path: String

Der auszuführende URL-Pfad.

writer: TextWriter

The TextWriter to capture the output.

preserveForm: Boolean

trueum die Auflistungen QueryString und die Sammlungen zu erhalten, Form um die falseQueryString Auflistungen Form zu löschen.

Ausnahmen

HttpException

Die aktuelle HttpContext ist ein Nullverweis (Nothing in Visual Basic).

-oder-

path endet mit einem Punkt (.).

-oder-

Fehler beim Ausführen des durch path.

ArgumentNullException

path ist null.

ArgumentException

path ist kein virtueller Pfad.

Beispiele

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

Hinweise

Weitere Informationen

Transfer

Gilt für:

Execute(IHttpHandler, TextWriter, Boolean)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Eine TextWriter Erfassung der Ausgabe des ausgeführten Handlers und eines booleschen Parameters gibt an, ob die QueryString Auflistungen gelöscht werden Form sollen.

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)

Parameter

handler: IHttpHandler

Der HTTP-Handler, der die IHttpHandler übertragung der aktuellen Anforderung implementiert.

writer: TextWriter

The TextWriter to capture the output.

preserveForm: Boolean

trueum die Auflistungen QueryString und die Sammlungen zu erhalten, Form um die falseQueryString Auflistungen Form zu löschen.

Ausnahmen

HttpException

Fehler beim Ausführen des durch handler.

ArgumentNullException

Der handler Parameter ist null.

Hinweise

Sie können benutzerdefinierte HTTP-Handler schreiben, um bestimmte, vordefinierte Typen von HTTP-Anforderungen in jeder Sprache zu verarbeiten, die mit der Common Language Specification (CLS) kompatibel ist. Ausführbarer Code, der in den HTTP-Handlerklassen definiert ist, anstelle herkömmlicher ASP-Seiten (auch als klassische ASP bezeichnet) oder ASP.NET Seiten reagiert auf diese spezifischen Anforderungen. HTTP-Handler ermöglichen die Interaktion mit den Low-Level-Anforderungs- und Antwortdiensten eines Webservers, auf dem Internetinformationsdienste (INTERNET Information Services, IIS) ausgeführt werden, und sie bieten Funktionen, die isAPI-Erweiterungen ähneln, aber mit einem einfacheren Programmiermodell.

ASP.NET überprüft nicht, ob der aktuelle Benutzer berechtigt ist, die Ressource anzuzeigen, die von der methode Execute bereitgestellt wird. Obwohl die ASP.NET Autorisierungs- und Authentifizierungslogik ausgeführt wird, bevor der ursprüngliche Ressourcenhandler aufgerufen wird, ruft ASP.NET den Handler direkt auf, der durch die methode Execute angegeben ist, und führt die Authentifizierungs- und Autorisierungslogik für die neue Ressource nicht erneut aus. Wenn die Sicherheitsrichtlinie für Ihre Anwendung eine entsprechende Autorisierung für den Zugriff auf die Ressource benötigt, sollte die Anwendung die erneute Dokumenterstellung erzwingen oder einen benutzerdefinierten Zugriffssteuerungsmechanismus bereitstellen.

Sie können die erneute Dokumenterstellung erzwingen, indem Sie die Redirect Methode anstelle der Execute Methode verwenden. Dies Redirect führt eine clientseitige Umleitung aus, in der der Browser die neue Ressource anfordert. Da es sich bei dieser Umleitung um eine neue Anforderung handelt, die das System eingibt, unterliegt sie allen Authentifizierungs- und Autorisierungslogiken sowohl der IIS- als auch ASP.NET Sicherheitsrichtlinie.

Weitere Informationen

Transfer

Gilt für:

Feedback

War diese Seite hilfreich?