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 управления значение из ScriptManager определяет используемую ScriptMode версию клиентского скрипта.
Release	3	В элементе управления ScriptManager на веб-странице используется версия выпуска клиентского сценария, если это не переопределено в экземпляре ScriptMode установкой значения ScriptReference для свойства Debug. В элементе управления ScriptReference на веб-странице используется версия выпуска клиентского сценария.

Примеры

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

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

Примечание

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