ScriptMode Výčet

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.Extensions.dll

Určuje, zda ScriptManager a ScriptReference objekty odkazují na ladicí nebo vydané verze klientských skriptů.

public enum class ScriptMode

public enum ScriptMode

type ScriptMode = 

Public Enum ScriptMode

Dědičnost

Object

ValueType

Enum

ScriptMode

Pole

Auto	0	V ovládacím ScriptManager prvku je verze klientských skriptů, které se mají použít, určena za běhu na základě elementu kompilace> na úrovni< aplikace Web.config souboru, pokud není přepsána v instanci ScriptReference ovládacího prvku. V ovládacím ScriptReference prvku je při použití na samostatný soubor Auto skriptu ekvivalentní Release. Při použití u odkazu na skript v sestavení Auto je ekvivalentní Inherit.
Debug	2	V ovládacím ScriptManager prvku se na webové stránce používá verze ladění klientského skriptu, pokud není přepsána v instanci ScriptReference ovládacího prvku. V ovládacím ScriptReference prvku se na webové stránce používá verze ladění klientského skriptu.
Inherit	1	V ovládacím ScriptManager prvku Inherit je ekvivalentní Auto. V ovládacím ScriptReference prvku ScriptMode určuje hodnota, ze ScriptManager které verze klientského skriptu se má použít.
Release	3	V ovládacím ScriptManager prvku se verze klientského skriptu používá na webové stránce, pokud není přepsána nastavením ScriptMode vlastnosti ScriptReference instance na Debug. V ovládacím ScriptReference prvku se verze klientského skriptu používá na webové stránce.

Příklady

Následující příklad ukazuje stránku, kde jsou verze skriptu deklarativní nastaveny na Release v ovládacím ScriptManager prvku, ale jeden skript s názvem CustomClient.js je deklarativní nastaven na Ladit v ovládacím Name prvku.

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

Poznámky

Výčet ScriptMode poskytuje hodnoty pro nastavení verze klientského skriptu, který se má použít na webové stránce. Hodnoty výčtu ScriptManager.ScriptMode lze použít na vlastnost nebo na ScriptReference.ScriptMode vlastnost. Objekt ScriptManager nastaví verzi pro všechny skripty na stránce, pokud není přepsán objektem ScriptReference . Objekt ScriptReference nastaví verzi konkrétního skriptu.

Hodnota ScriptMode.Auto vytváří různé výsledky v závislosti na tom, jestli odkazuje na samostatný soubor skriptu nebo na soubor skriptu, který je vložen jako prostředek v sestavení. Samostatný soubor skriptu je definován pomocí ScriptReference.Path vlastnost. Odkaz na sestavení musí být přístupný prostřednictvím Name vlastností a Assembly vlastností. Výsledky hodnoty ScriptMode.Auto jsou následující:

• Při použití na samostatný soubor skriptu, kde je zadána ScriptMode.Auto vlastnost [ScriptReference.Path],Path je hodnota ekvivalentní ScriptMode.Release.

• Při použití u odkazu na skript v sestavení ScriptMode.Auto je ekvivalentní ScriptMode.Inherit. Pokud je zadán pouze Name , používá se k odkazování na skript. Když Name a [ScriptReference.Path]Path vlastnost jsou zadány, [ScriptReference.Path]Path vlastnost je použita místo Name, ale ScriptMode.Auto hodnota je stále ekvivalentní ScriptMode.Inherit.

Pokud požadovaná verze skriptu neexistuje, vyvolá se chyba. Například chyba se vyvolá, pokud se odkazuje na samostatný soubor skriptu s názvem CustomScript.js a ScriptManager.ScriptMode vlastnost je nastavena na ScriptMode.Debug, ale CustomScript.debug.js na webu neexistuje. Odkazy na skripty v sestavení vrátí verzi vydané verze, pokud verze ladění neexistuje.

Poznámka

retail Pokud je atribut elementu nasazení souboru Machine.config nastaven na true, verze verzí klientských skriptů se používají na celém webu. Hodnoty ScriptMode ve vlastnostech ScriptManager.ScriptMode ScriptReference.ScriptMode jsou ignorovány.