ScriptMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, на какую версию (отладки или выпуска) клиентских скриптов ссылаются объекты ScriptManager и ScriptReference.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public 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 игнорируются.
