ScriptMode Výčet

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.Extensions.dll

Určuje, jestli ScriptManager objekty a ScriptReference odkazují na ladicí nebo vydanou verzi 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. Pokud se v ovládacím ScriptReference prvku použije na soubor samostatného skriptu, Auto je ekvivalentní k Release. Při použití odkazu na skript v sestavení je Auto ekvivalentní k Inherit.
Debug	2	V ovládacím ScriptManager prvku se na webové stránce používá ladicí verze 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á ladicí verze klientského skriptu.
Inherit	1	V ovládacím ScriptManager prvku Inherit je ekvivalentní k Auto. V ovládacím ScriptReference prvku hodnota z ScriptManager určuje verzi klientského skriptu, ScriptMode která 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 verze skriptů jsou deklarativně nastaveny na Release v ScriptManager ovládacím 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 pro použití na webové stránce. Hodnoty výčtu mohou být použity buď vlastnost ScriptManager.ScriptMode nebo ScriptReference.ScriptMode vlastnost. Objekt ScriptManager nastaví verzi pro všechny skripty na stránce, pokud ho objekt nepřepíše ScriptReference . Objekt ScriptReference nastaví verzi pro konkrétní skript.

Hodnota ScriptMode.Auto vytváří různé výsledky v závislosti na tom, zda odkazuje na soubor samostatného skriptu nebo na soubor skriptu, který je vložen jako prostředek v sestavení. Samostatný soubor skriptu je definován s ScriptReference.Path vlastnost. Odkaz na sestavení musí být přístupný prostřednictvím Name vlastností a Assembly . Výsledky pro ScriptMode.Auto hodnotu 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.Releasek .

• Je-li použit na odkaz na skript v sestavení, ScriptMode.Auto je ekvivalentní k ScriptMode.Inherit. Pokud je zadán pouze Name parametr , použije se k odkazování na skript. Pokud Name jsou zadány obě vlastnosti a [ScriptReference.Path],Path použije se vlastnost [ScriptReference.Path]Path místo Name, ale ScriptMode.Auto hodnota je stále ekvivalentní k ScriptMode.Inherit.

Pokud požadovaná verze skriptu neexistuje, vyvolá se chyba. Například dojde k chybě, pokud je proveden odkaz na soubor samostatného 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í vydanou verzi, pokud ladicí verze neexistuje.

Poznámka

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