HttpServerUtility.Execute Metódus

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Végrehajtja egy adott erőforrás kezelőjének feladatát az aktuális kérés kontextusában, és visszaadja a végrehajtást az azt megindító lapra.

Túlterhelések

Name	Description
Execute(String)	A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában.
Execute(String, Boolean)	Végrehajtja a megadott virtuális elérési út kezelőjének az aktuális kérés kontextusában, és megadja, hogy törölje-e a gyűjteményeket és Form a QueryString gyűjteményeket.
Execute(String, TextWriter)	A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában. A TextWriter végrehajtott kezelő kimenetét rögzíti.
Execute(String, TextWriter, Boolean)	A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában. A TextWriter lap kimenetét rögzíti, a logikai paraméter pedig azt határozza meg, hogy törölje-e a gyűjteményeket és Form a QueryString gyűjteményeket.
Execute(IHttpHandler, TextWriter, Boolean)	A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában. A TextWriter végrehajtott kezelő kimenetét rögzíti, a logikai paraméter pedig azt határozza meg, hogy törölje-e a gyűjteményeket és Form a QueryString gyűjteményeket.

Execute(String)

A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában.

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

public void Execute(string path);

member this.Execute : string -> unit

Public Sub Execute (path As String)

Paraméterek

path: String

A végrehajtandó URL-cím.

Kivételek

HttpException

Az aktuális HttpContext állapot.null

-vagy-

Hiba történt a megadott kezelő pathvégrehajtása közben.

ArgumentNullException

path az null.

-vagy-

path nem virtuális elérési út.

Példák

Az alábbi példában a .aspx lap "Updateinfo.aspx" jelenik meg az aktuális könyvtárban. A programvégrehajtás a Updateinfo.aspx lap megjelenítése után tér vissza a kezdőoldalra.

Server.Execute("updateinfo.aspx");

Server.Execute("updateinfo.aspx")

Megjegyzések

A Execute metódus az új lap végrehajtása után is folytatja az eredeti lap végrehajtását. A Transfer metódus feltétel nélkül átadja a végrehajtást egy másik kezelőnek.

ASP.NET nem ellenőrzi, hogy az aktuális felhasználó jogosult-e a Execute metódus által szállított erőforrás megtekintésére. Bár a ASP.NET engedélyezési és hitelesítési logika az eredeti erőforrás-kezelő meghívása előtt fut, ASP.NET közvetlenül meghívja a Execute metódus által jelzett kezelőt, és nem futtatja újra az új erőforrás hitelesítési és engedélyezési logikáját. Ha az alkalmazás biztonsági szabályzata megköveteli, hogy az ügyfelek megfelelő engedéllyel rendelkezzenek az erőforrás eléréséhez, az alkalmazásnak újrahitelesítést kell kényszerítenie, vagy egyéni hozzáférés-vezérlési mechanizmust kell biztosítania.

A metódus helyett a Redirect metódus használatával kényszerítheti az újrahitelesítést Execute . Redirect Ügyféloldali átirányítást hajt végre, amelyben a böngésző kéri az új erőforrást. Mivel ez az átirányítás egy új kérés, amely belép a rendszerbe, az Internet Information Services (IIS) és ASP.NET biztonsági szabályzat összes hitelesítési és engedélyezési logikájának ki van téve.

A metódust használó IsInRole egyéni engedélyezési módszer beépítésével ellenőrizheti, hogy a felhasználó rendelkezik-e engedéllyel az erőforrás megtekintéséhez, mielőtt az alkalmazás meghívja a metódust Execute .

A következőre érvényes:

Execute(String, Boolean)

Végrehajtja a megadott virtuális elérési út kezelőjének az aktuális kérés kontextusában, és megadja, hogy törölje-e a gyűjteményeket és Form a QueryString gyűjteményeket.

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éterek

path: String

A végrehajtandó URL-cím.

preserveForm: Boolean

truea gyűjtemények és Form gyűjtemények QueryString megőrzéséhez; false a gyűjtemények és Form gyűjtemények QueryString törléséhez.

Kivételek

HttpException

Az aktuális HttpContext állapot.null

-vagy-

Hiba történt a megadott kezelő pathvégrehajtása közben.

ArgumentNullException

path az null.

-vagy-

path nem virtuális elérési út.

Példák

Az alábbi példa bemutatja, hogyan hajthatja végre a .aspx lapot Updateinfo.aspx az aktuális kérelemben, és hogyan őrizheti meg a QueryString gyűjteményeket.Form A program végrehajtása a megjelenítés után Updateinfo.aspx visszatér a kezdőoldalra.

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

Lásd még

Transfer

A következőre érvényes:

Execute(String, TextWriter)

A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában. A TextWriter végrehajtott kezelő kimenetét rögzíti.

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éterek

path: String

A végrehajtandó URL-cím.

writer: TextWriter

A TextWriter kimenet rögzítéséhez.

Kivételek

HttpException

Az aktuális HttpContext állapot.null

-vagy-

Hiba történt a megadott kezelő pathvégrehajtása közben.

ArgumentNullException

path az null.

-vagy-

path nem virtuális elérési út.

Példák

Az alábbi példa végrehajtja a lapot az Login.aspx aktuális könyvtár kiszolgálóján, és az objektumon writerkeresztül fogadja a kimenetet a StringWriter lapról. A HTTP-kimeneti streambe writer kapott HTML-adatfolyamot írja.

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

Megjegyzések

A Execute metódus a megadott virtuális útvonal végrehajtása után is folytatja az eredeti kérés végrehajtását. A Transfer metódus feltétel nélkül átadja a végrehajtást egy másik kezelőnek.

Lásd még

Transfer

A következőre érvényes:

Execute(String, TextWriter, Boolean)

A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában. A TextWriter lap kimenetét rögzíti, a logikai paraméter pedig azt határozza meg, hogy törölje-e a gyűjteményeket és Form a QueryString gyűjteményeket.

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éterek

path: String

A végrehajtandó URL-cím.

writer: TextWriter

A TextWriter kimenet rögzítéséhez.

preserveForm: Boolean

truea gyűjtemények és Form gyűjtemények QueryString megőrzéséhez; false a gyűjtemények és Form gyűjtemények QueryString törléséhez.

Kivételek

HttpException

Az aktuális HttpContext null értékű hivatkozás (Nothing Visual Basic).

-vagy-

path ponttal (.) végződik.

-vagy-

Hiba történt a megadott kezelő pathvégrehajtása közben.

ArgumentNullException

path az null.

ArgumentException

path nem virtuális elérési út.

Példák

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

Megjegyzések

A Execute metódus a megadott virtuális elérési út végrehajtása után is folytatja az eredeti kérés végrehajtását. A Transfer metódus feltétel nélkül átadja a végrehajtást egy másik kezelőnek.

Lásd még

Transfer

A következőre érvényes:

Execute(IHttpHandler, TextWriter, Boolean)

A megadott virtuális útvonal kezelőjének végrehajtása az aktuális kérés kontextusában. A TextWriter végrehajtott kezelő kimenetét rögzíti, a logikai paraméter pedig azt határozza meg, hogy törölje-e a gyűjteményeket és Form a QueryString gyűjteményeket.

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éterek

handler: IHttpHandler

Az a HTTP-kezelő, amely megvalósítja az IHttpHandler aktuális kérés átvitelét.

writer: TextWriter

A TextWriter kimenet rögzítéséhez.

preserveForm: Boolean

truea gyűjtemények és Form gyűjtemények QueryString megőrzéséhez; false a gyűjtemények és Form gyűjtemények QueryString törléséhez.

Kivételek

HttpException

Hiba történt a megadott kezelő handlervégrehajtása közben.

ArgumentNullException

A handler paraméter a következő null: .

Megjegyzések

Egyéni HTTP-kezelőket írhat a HTTP-kérések meghatározott, előre definiált típusainak feldolgozásához bármely olyan nyelven, amely megfelel a Common Language Specification (CLS) szabványnak. A HTTP-kezelőosztályokban definiált végrehajtható kód a hagyományos ASP-(más néven klasszikus ASP-) lapok vagy ASP.NET lapok helyett válaszol ezekre a kérésekre. A HTTP-kezelők lehetővé teszik az Internet Information Services (IIS) rendszert futtató webkiszolgálók alacsony szintű kérés- és válaszszolgáltatásainak kezelését, és olyan funkciókat biztosítanak, amelyek hasonlóak az ISAPI-bővítményekhez, de egyszerűbb programozási modellel rendelkeznek.

ASP.NET nem ellenőrzi, hogy az aktuális felhasználó jogosult-e a Execute metódus által szállított erőforrás megtekintésére. Bár a ASP.NET engedélyezési és hitelesítési logika az eredeti erőforrás-kezelő meghívása előtt fut, ASP.NET közvetlenül meghívja a Execute metódus által jelzett kezelőt, és nem futtatja újra az új erőforrás hitelesítési és engedélyezési logikáját. Ha az alkalmazás biztonsági szabályzata megköveteli, hogy az ügyfelek megfelelő engedéllyel rendelkezzenek az erőforráshoz való hozzáféréshez, az alkalmazásnak újrahitelesítést kell kényszerítenie, vagy egyéni hozzáférés-vezérlési mechanizmust kell biztosítania.

A metódus helyett a Redirect metódus használatával kényszerítheti az újrahitelesítést Execute . A Redirect rendszer ügyféloldali átirányítást hajt végre, amelyben a böngésző kéri az új erőforrást. Mivel ez az átirányítás egy új kérés, amely belép a rendszerbe, az IIS és ASP.NET biztonsági szabályzat összes hitelesítési és engedélyezési logikájának ki van téve.

Lásd még

Transfer

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?