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

Примеры

В следующем примере показана страница, на которой версии скриптов декларативно задаются в качестве выпуска в элементе ScriptManager управления, но один скрипт с именем CustomClient.js декларативно задается в качестве отладки в элементе 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]Path указаны, свойство [ScriptReference.Path]Path используется вместо Nameзначения, но ScriptMode.Auto значение по-прежнему эквивалентно ScriptMode.Inherit.

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

Примечание

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