HttpServerUtility.Execute Methode

Definitie

Naamruimte:: System.Web

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voert de handler uit voor een opgegeven resource in de context van de huidige aanvraag en retourneert de uitvoering naar de pagina die deze heeft aangeroepen.

Overloads

Name	Description
Execute(String)	Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag.
Execute(String, Boolean)	Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag en wordt aangegeven of de QueryString en Form verzamelingen moeten worden gewist.
Execute(String, TextWriter)	Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag. Een TextWriter legt uitvoer van de uitgevoerde handler vast.
Execute(String, TextWriter, Boolean)	Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag. Een TextWriter legt uitvoer van de pagina vast en een Booleaanse parameter geeft aan of de QueryString en Form verzamelingen moeten worden gewist.
Execute(IHttpHandler, TextWriter, Boolean)	Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag. Een TextWriter legt uitvoer van de uitgevoerde handler vast en een Booleaanse parameter geeft aan of de QueryString en Form verzamelingen moeten worden gewist.

Execute(String)

Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag.

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

public void Execute(string path);

member this.Execute : string -> unit

Public Sub Execute (path As String)

Parameters

path: String

Het URL-pad dat moet worden uitgevoerd.

Uitzonderingen

HttpException

De huidige HttpContext is null.

– of –

Er is een fout opgetreden tijdens het uitvoeren van de handler die is opgegeven door path.

ArgumentNullException

path is null.

– of –

path is geen virtueel pad.

Voorbeelden

In het volgende voorbeeld wordt de .aspx pagina 'Updateinfo.aspx' weergegeven in de huidige map. Uitvoering van het programma keert terug naar de startpagina nadat de Updateinfo.aspx pagina wordt weergegeven.

Server.Execute("updateinfo.aspx");

Server.Execute("updateinfo.aspx")

Opmerkingen

De Execute methode gaat verder met de uitvoering van de oorspronkelijke pagina nadat de uitvoering van de nieuwe pagina is voltooid. De Transfer methode draagt de uitvoering voorwaardelijke over naar een andere handler.

ASP.NET controleert niet of de huidige gebruiker gemachtigd is om de resource weer te geven die wordt geleverd door de methode Execute. Hoewel de ASP.NET autorisatie- en verificatielogica wordt uitgevoerd voordat de oorspronkelijke resourcehandler wordt aangeroepen, ASP.NET rechtstreeks de handler aangeroepen die wordt aangegeven door de methode Execute en geen verificatie- en autorisatielogica voor de nieuwe resource opnieuw uitvoert. Als het beveiligingsbeleid van uw toepassing vereist dat clients over de juiste autorisatie beschikken om toegang te krijgen tot de resource, moet de toepassing verificatie afdwingen of een aangepast mechanisme voor toegangsbeheer opgeven.

U kunt herauthorisatie afdwingen met behulp van de Redirect methode in plaats van de Execute methode. Redirect voert een omleiding aan de clientzijde uit waarin de browser de nieuwe resource aanvraagt. Omdat deze omleiding een nieuwe aanvraag is die het systeem invoert, wordt deze onderworpen aan alle verificatie- en autorisatielogica van zowel Internet Information Services (IIS) als ASP.NET beveiligingsbeleid.

U kunt controleren of de gebruiker gemachtigd is om de resource weer te geven door een aangepaste autorisatiemethode op te nemen die gebruikmaakt van de IsInRole methode voordat de toepassing de Execute methode aanroept.

Van toepassing op

Execute(String, Boolean)

Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag en wordt aangegeven of de QueryString en Form verzamelingen moeten worden gewist.

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)

Parameters

path: String

Het URL-pad dat moet worden uitgevoerd.

preserveForm: Boolean

true om de QueryString en Form verzamelingen te behouden; false om de QueryString en Form verzamelingen te wissen.

Uitzonderingen

HttpException

De huidige HttpContext is null.

– of –

Er is een fout opgetreden tijdens het uitvoeren van de handler die is opgegeven door path.

ArgumentNullException

path is null.

– of –

path is geen virtueel pad.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de pagina .aspx Updateinfo.aspx in de huidige aanvraag uitvoert en de QueryString en Form verzamelingen behoudt. De uitvoering van het programma keert terug naar de startpagina nadat Updateinfo.aspx deze is weergegeven.

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

Zie ook

Transfer

Van toepassing op

Execute(String, TextWriter)

Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag. Een TextWriter legt uitvoer van de uitgevoerde handler vast.

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)

Parameters

path: String

Het URL-pad dat moet worden uitgevoerd.

writer: TextWriter

De TextWriter om de uitvoer vast te leggen.

Uitzonderingen

HttpException

De huidige HttpContext is null.

– of –

Er is een fout opgetreden tijdens het uitvoeren van de handler die is opgegeven door path.

ArgumentNullException

path is null.

– of –

path is geen virtueel pad.

Voorbeelden

In het volgende voorbeeld wordt de Login.aspx pagina op de server in de huidige map uitgevoerd en wordt de uitvoer van de pagina via het StringWriter object writerontvangen. Hiermee wordt de HTML-stroom geschreven van writer waaruit naar de HTTP-uitvoerstroom is ontvangen.

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

Opmerkingen

De Execute methode gaat door met de uitvoering van de oorspronkelijke aanvraag nadat de uitvoering van het opgegeven virtuele pad is voltooid. De Transfer methode draagt de uitvoering voorwaardelijke over naar een andere handler.

Zie ook

Transfer

Van toepassing op

Execute(String, TextWriter, Boolean)

Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag. Een TextWriter legt uitvoer van de pagina vast en een Booleaanse parameter geeft aan of de QueryString en Form verzamelingen moeten worden gewist.

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)

Parameters

path: String

Het URL-pad dat moet worden uitgevoerd.

writer: TextWriter

De TextWriter om de uitvoer vast te leggen.

preserveForm: Boolean

true om de QueryString en Form verzamelingen te behouden; false om de QueryString en Form verzamelingen te wissen.

Uitzonderingen

HttpException

De huidige HttpContext is een null-verwijzing (Nothing in Visual Basic).

– of –

path eindigt met een punt (.).

– of –

Er is een fout opgetreden tijdens het uitvoeren van de handler die is opgegeven door path.

ArgumentNullException

path is null.

ArgumentException

path is geen virtueel pad.

Voorbeelden

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

Opmerkingen

Zie ook

Transfer

Van toepassing op

Execute(IHttpHandler, TextWriter, Boolean)

Hiermee wordt de handler uitgevoerd voor het opgegeven virtuele pad in de context van de huidige aanvraag. Een TextWriter legt uitvoer van de uitgevoerde handler vast en een Booleaanse parameter geeft aan of de QueryString en Form verzamelingen moeten worden gewist.

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)

Parameters

handler: IHttpHandler

De HTTP-handler waarmee de IHttpHandler huidige aanvraag wordt overgedragen.

writer: TextWriter

De TextWriter om de uitvoer vast te leggen.

preserveForm: Boolean

true om de QueryString en Form verzamelingen te behouden; false om de QueryString en Form verzamelingen te wissen.

Uitzonderingen

HttpException

Er is een fout opgetreden tijdens het uitvoeren van de handler die is opgegeven door handler.

ArgumentNullException

De handler parameter is null.

Opmerkingen

U kunt aangepaste HTTP-handlers schrijven om specifieke, vooraf gedefinieerde typen HTTP-aanvragen te verwerken in elke taal die voldoet aan de Common Language Specification (CLS). Uitvoerbare code die is gedefinieerd in de HTTP-handlerklassen in plaats van conventionele ASP-pagina's (ook wel klassieke ASP-pagina's genoemd) of ASP.NET pagina's reageert op deze specifieke aanvragen. HTTP-handlers maken interactie mogelijk met de aanvraag- en antwoordservices op laag niveau van een webserver waarop Internet Information Services (IIS) wordt uitgevoerd, en bieden functionaliteit die vergelijkbaar is met ISAPI-extensies, maar met een eenvoudiger programmeermodel.

ASP.NET controleert niet of de huidige gebruiker gemachtigd is om de resource weer te geven die wordt geleverd door de methode Execute. Hoewel de ASP.NET autorisatie- en verificatielogica wordt uitgevoerd voordat de oorspronkelijke resourcehandler wordt aangeroepen, roept ASP.NET rechtstreeks de handler aan die wordt aangegeven door de methode Execute en voert de verificatie- en autorisatielogica niet opnieuw uit voor de nieuwe resource. Als het beveiligingsbeleid voor uw toepassing vereist dat clients over de juiste autorisatie beschikken om toegang te krijgen tot de resource, moet de toepassing verificatie afdwingen of een aangepast toegangsbeheermechanisme opgeven.

U kunt herauthorisatie afdwingen met behulp van de Redirect methode in plaats van de Execute methode. Hiermee Redirect wordt een omleiding aan de clientzijde uitgevoerd waarin de browser de nieuwe resource aanvraagt. Omdat deze omleiding een nieuwe aanvraag is die het systeem invoert, wordt deze onderworpen aan alle verificatie- en autorisatielogica van zowel het IIS- als ASP.NET-beveiligingsbeleid.

Zie ook

Transfer

Van toepassing op

Feedback

Is deze pagina nuttig?