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

Name	Hodnota	Description
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 souboru Web.config, 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í na odkaz na skript v sestavení, Auto je ekvivalentní .Inherit
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.
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.
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 Debughodnotu . V ovládacím ScriptReference prvku se na webové stránce používá verze klientského skriptu.

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 lze použít buď na ScriptManager.ScriptMode 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, zda 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 pro ScriptMode.Auto hodnotu jsou následující:

• Pokud se použije na samostatný soubor skriptu, kde je zadána ScriptMode.Auto vlastnost [ScriptReference.Path],Path je hodnota ekvivalentní ScriptMode.Release.

• Při použití na odkaz skriptu v sestavení, ScriptMode.Auto je ekvivalentní ScriptMode.Inherit. Je-li zadán pouze Name , slouží k odkazování na skript. Při Name a [ScriptReference.Path] vlastnost jsou zadány, [ScriptReference.Path]PathPath 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 je vyvolán, pokud je odkaz na samostatný soubor skriptu s názvem CustomScript.js a ScriptManager.ScriptMode vlastnost je nastavena na ScriptMode.Debug, ale CustomScript.debug.js neexistuje na webu. Odkazy na skripty v sestavení vrátí verzi vydané verze, pokud ladicí verze neexistuje.

Poznámka:

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