ScriptMode Enumeráció

Definíció

Megadja, hogy az objektumok az ScriptManager ügyfélszkriptek hibakeresési vagy kiadási verziójára hivatkoznak-eScriptReference.

public enum class ScriptMode
public enum ScriptMode
type ScriptMode = 
Public Enum ScriptMode
Öröklődés
ScriptMode

Mezők

Name Érték Description
Auto 0

A vezérlőben a ScriptManager használni kívánt ügyfélszkriptek verziója futásidőben lesz meghatározva a Web.config fájl alkalmazásszintű <fordítási> eleme alapján, kivéve, ha felülbírálják a ScriptReference vezérlő egy példányában. A vezérlőben ScriptReference , ha önálló szkriptfájlra van alkalmazva, Auto az egyenértékű a következővel Release: . Ha egy szerelvény szkripthivatkozására van alkalmazva, Auto az egyenértékű a következővel Inherit: .

Inherit 1

A vezérlőben ScriptManagerInherit a Auto. A vezérlőben az ScriptReferenceScriptMode érték ScriptManager határozza meg az ügyfélszkript melyik verzióját használja.

Debug 2

A vezérlőben ScriptManager az ügyfélszkript hibakeresési verzióját használja a rendszer a weblapon, kivéve, ha a vezérlő egy példányában felülbírálják.ScriptReference A vezérlőben ScriptReference az ügyfélszkript hibakeresési verzióját használja a rendszer a weblapon.

Release 3

A vezérlőben ScriptManager az ügyfélszkript ScriptMode kiadási verziója lesz használva a weblapon, kivéve, ha felülbírált egy ScriptReference példány Debugtulajdonságát. A vezérlőben ScriptReference az ügyfélszkript kiadási verziója lesz használva a weblapon.

Példák

Az alábbi példa egy olyan oldalt mutat be, ahol a szkriptverziók deklaratívan Release értékre vannak állítva a ScriptManager vezérlőben, de egy CustomClient.js nevű szkript deklaratívan deklaratív módon deklarálva van beállítva a Name vezérlőben.

<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
    <Scripts>
        <asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
    </Scripts>
</asp:ScriptManager>
<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
    <Scripts>
        <asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
    </Scripts>
</asp:ScriptManager>

Megjegyzések

Az ScriptMode enumerálás értékeket biztosít az ügyfélszkript weblapon való használatához. Az enumerálási értékek a tulajdonságra vagy a ScriptManager.ScriptModeScriptReference.ScriptMode tulajdonságra is alkalmazhatók. Az ScriptManager objektum beállítja a lap összes szkriptjének verzióját, kivéve, ha egy objektum felülbírálta ScriptReference . Az ScriptReference objektum beállítja egy adott szkript verzióját.

Az ScriptMode.Auto érték különböző eredményeket eredményez attól függően, hogy önálló szkriptfájlra vagy egy szerelvény erőforrásaként beágyazott szkriptfájlra hivatkozik. A ScriptReference.Path tulajdonsággal önálló szkriptfájl van definiálva. A szerelvényhivatkozást a Name tulajdonságokon Assembly keresztül kell elérni. Az érték eredménye a ScriptMode.Auto következő:

  • Ha olyan önálló szkriptfájlra alkalmazza, amelyben a [ScriptReference.Path]Path tulajdonság meg van adva, az ScriptMode.Auto érték egyenértékű a következővel ScriptMode.Release: .

  • Ha egy szerelvény szkripthivatkozására alkalmazza, ScriptMode.Auto az egyenértékű a következővel ScriptMode.Inherit: . Ha csak Name meg van adva, a szkriptre való hivatkozásra szolgál. Amikor Name és a [ScriptReference.Path]Path tulajdonság is meg van adva, a [ScriptReference.Path] tulajdonság helyett a [ScriptReference.Path]Path tulajdonságot használja Namea rendszer, de az ScriptMode.Auto érték továbbra is egyenértékű.ScriptMode.Inherit

Hibaüzenet jelenik meg, ha a szkript kért verziója nem létezik. Ha például egy CustomScript.js nevű önálló szkriptfájlra hivatkozik, a ScriptManager.ScriptMode tulajdonság ScriptMode.Debugértéke pedig az , de CustomScript.debug.js nem létezik a webhelyen. Ha a hibakeresési verzió nem létezik, a szerelvény szkriptjeire mutató hivatkozások a kiadási verziót adják vissza.

Note

Ha a retail Machine.config fájl üzembehelyezési elemének attribútuma a következőre truevan állítva, az ügyfélszkriptek kiadási verzióit használja a webhely. A ScriptMode rendszer figyelmen kívül hagyja a ScriptManager.ScriptModeScriptReference.ScriptMode tulajdonság értékeit.

A következőre érvényes: