ScriptMode Перечисление

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.Extensions.dll

Указывает, относятся ли объекты ScriptManager и ScriptReference к отладочной или выпускной версии клиентских скриптов.

public enum class ScriptMode

public enum ScriptMode

type ScriptMode = 

Public Enum ScriptMode

Наследование

Object

ValueType

Enum

ScriptMode

Поля

Имя	Значение	Описание
Auto	0	В элементе ScriptManager управления версия клиентских скриптов, используемых во время выполнения, определяется на основе элемента компиляции> на уровне< приложения файла Web.config, если он не переопределен в экземпляре ScriptReference элемента управления. В элементе ScriptReference управления при применении к автономному файлу Auto скрипта эквивалентен Release. При применении к ссылке на скрипт в сборке Auto эквивалентно Inherit.
Inherit	1	В элементе ScriptManager управления Inherit эквивалентен Auto. В элементе ScriptReference управления ScriptMode значение ScriptManager определяет, какая версия клиентского скрипта используется.
Debug	2	В элементе ScriptManager управления отладочная версия клиентского скрипта используется на веб-странице, если не переопределяется в экземпляре ScriptReference элемента управления. В элементе ScriptReference управления на веб-странице используется отладочная версия клиентского скрипта.
Release	3	В элементе ScriptManager управления версия выпуска клиентского скрипта используется на веб-странице, если не переопределяется, задав ScriptMode для свойства экземпляра ScriptReference значение Debug. В элементе ScriptReference управления версия выпуска клиентского скрипта используется на веб-странице.

Примеры

В следующем примере показана страница, на которой версии скрипта декларативно заданы в качестве выпуска в элементе ScriptManager управления, но один скрипт с именем CustomClient.js декларативно установлен в значение Debug в элементе Name управления.

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

Комментарии

Перечисление ScriptMode содержит значения для задания версии клиентского скрипта, используемой на веб-странице. Значения перечисления можно применять либо к свойству, либо ScriptManager.ScriptMode к свойству ScriptReference.ScriptMode . Объект ScriptManager задает версию для всех скриптов на странице, если она не переопределяется ScriptReference объектом. Объект ScriptReference задает версию для определенного скрипта.

Значение ScriptMode.Auto создает разные результаты в зависимости от того, относится ли он к автономному файлу скрипта или к файлу скрипта, внедренному в качестве ресурса в сборке. Автономный файл скрипта определяется свойством ScriptReference.Path . Ссылка на сборку должна быть доступ к ней Name через свойства и Assembly свойства. Результаты для ScriptMode.Auto значения приведены следующим образом:

• При применении к автономному файлу скрипта, в котором указано свойство [ScriptReference.Path]Path , ScriptMode.Auto значение эквивалентно ScriptMode.Release.

• Если он применяется к ссылке на скрипт в сборке, ScriptMode.Auto эквивалентен ScriptMode.Inherit. При указании только Name он используется для ссылки на скрипт. Когда Name и свойство [ScriptReference.Path] указаны, свойство [ScriptReference.Path]PathPath используется вместо Nameэтого, но ScriptMode.Auto значение по-прежнему эквивалентноScriptMode.Inherit.

Ошибка возникает, если запрошенная версия скрипта не существует. Например, возникает ошибка, если ссылка сделана на автономный файл скрипта, который называется CustomScript.js и ScriptManager.ScriptMode свойством задано ScriptMode.Debugзначение, но CustomScript.debug.js не существует на сайте. Ссылки на скрипты в сборке возвращают версию выпуска, если отладочная версия не существует.

Замечание

retail Если для атрибута элемента развертывания файла Machine.config задано trueзначение , версии выпусков клиентских скриптов используются на веб-сайте. Значения ScriptMode свойств ScriptManager.ScriptModeScriptReference.ScriptMode игнорируются.