ScriptMode ScriptMode ScriptMode ScriptMode Enum

Определение

Указывает, на какую версию (отладки или выпуска) клиентских скриптов ссылаются объекты ScriptManager и ScriptReference.Specifies whether ScriptManager and ScriptReference objects refer to the debug or release version of client scripts.

public enum class ScriptMode
public enum ScriptMode
type ScriptMode = 
Public Enum ScriptMode
Наследование

Поля

Auto Auto Auto Auto 0

В элементе управления ScriptManager используемая версия клиентских скриптов определяется во время выполнения с учетом элемента <compilation> на уровне приложения в файле Web.config, если значение этого элемента не переопределено в экземпляре элемента управления ScriptReference.In the ScriptManager control, the version of client scripts to use is determined at run time based on the application-level <compilation> element of the Web.config file, unless it is overridden in an instance of the ScriptReference control. В элементе управления ScriptReference, применяемом в автономном файле скрипта, значение Auto эквивалентно значению Release.In the ScriptReference control, when applied to a standalone script file, Auto is equivalent to Release. При применении к ссылке на скрипт в сборке, значение Auto эквивалентно значению Inherit.When applied to a script reference in an assembly, Auto is equivalent to Inherit.

Debug Debug Debug Debug 2

В элементе управления ScriptManager на веб-странице используется отладочная версия клиентского сценария, если это не переопределено в экземпляре элемента управления ScriptReference.In the ScriptManager control, the debug version of the client script is used on the Web page unless overridden in an instance of the ScriptReference control. В элементе управления ScriptReference на веб-странице используется отладочная версия клиентского сценария.In the ScriptReference control, the debug version of the client script is used on the Web page.

Inherit Inherit Inherit Inherit 1

В элементе управления ScriptManager значение Inherit эквивалентно значению Auto.In the ScriptManager control, Inherit is equivalent to Auto. В элементе управления ScriptReference используемая версия клиентского сценария определяется значением ScriptMode, заданным в ScriptManager.In the ScriptReference control, the ScriptMode value from ScriptManager determines which version of the client script to use.

Release Release Release Release 3

В элементе управления ScriptManager на веб-странице используется версия выпуска клиентского сценария, если это не переопределено в экземпляре ScriptMode установкой значения ScriptReference для свойства Debug.In the ScriptManager control, the release version of the client script is used on the Web page unless overridden by setting the ScriptMode property of a ScriptReference instance to Debug. В элементе управления ScriptReference на веб-странице используется версия выпуска клиентского сценария.In the ScriptReference control, the release version of the client script is used on the Web page.

Примеры

В следующем примере показана страница, на которой версии скрипта декларативно настроены для выпуска ScriptManager в элементе управления, но для одного скрипта с именем кустомклиент. js декларативно задано значение Debug Name в элементе управления.The following example shows a page where the script versions are declaratively set to Release in the ScriptManager control, but one script named CustomClient.js is declaratively set to Debug in the Name control.

<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 Перечисление предоставляет значения для установки версии клиентского скрипта для использования на веб-странице.The ScriptMode enumeration provides values for setting the version of client script to use on a Web page. Значения перечисления можно применить либо ScriptManager.ScriptMode к свойству, либо к свойству ScriptReference. скриптмоде .The enumeration values can be applied to either the ScriptManager.ScriptMode property or to the ScriptReference.ScriptMode property. Объект задает версию для всех скриптов на странице, если она не переопределена ScriptReference объектом. ScriptManagerThe ScriptManager object sets the version for all scripts on the page unless it is overridden by a ScriptReference object. ScriptReference Объект задает версию для конкретного скрипта.The ScriptReference object sets the version for a particular script.

ScriptMode.Auto Значение получает разные результаты в зависимости от того, ссылается ли он на автономный файл скрипта или на файл скрипта, внедренный в сборку в качестве ресурса.The ScriptMode.Auto value produces different results depending on whether it refers to a standalone script file or to a script file that is embedded as a resource in an assembly. Автономный файл скрипта определяется свойством ScriptReference. Path .A standalone script file is defined with the ScriptReference.Path property. Доступ к ссылке на сборку должен осуществляться Name через Assembly свойства и.An assembly reference must be accessed through the Name and Assembly properties. Ниже приведены результаты для ScriptMode.Auto значения.The results for the ScriptMode.Auto value are as follows:

  • При применении к автономному файлу скриптаPath ScriptMode.Auto , в котором указано свойство [ScriptReference. path], значение эквивалентно ScriptMode.Releaseзначению.When it is applied to a standalone script file where the [ScriptReference.Path]Path property is specified, the ScriptMode.Auto value is equivalent to ScriptMode.Release.

  • При применении к ссылке на скрипт в сборке ScriptMode.Auto она ScriptMode.Inheritэквивалентна.When it is applied to a script reference in an assembly, ScriptMode.Auto is equivalent to ScriptMode.Inherit. Если указан Name только параметр, он используется для ссылки на скрипт.When only Name is specified, it is used to reference the script. Если Name для свойства [ScriptReference. path]Path заданы оба ScriptMode.Auto значения, вместо Nameиспользуется свойство [ScriptReference.Path path], а значение по-прежнему эквивалентно ScriptMode.Inheritзначению.When Name and the [ScriptReference.Path]Path property are both specified, the [ScriptReference.Path]Path property is used instead of Name, but the ScriptMode.Auto value is still equivalent to ScriptMode.Inherit.

Если запрошенная версия скрипта не существует, возникает ошибка.An error is thrown if the requested version of the script does not exist. Например, при создании ссылки на автономный файл скрипта с именем CustomScript. js ScriptManager.ScriptMode ScriptMode.Debugвыдается ошибка, но CustomScript. Debug. js не существует на сайте.For instance, an error is thrown if a reference is made to a standalone script file that is named CustomScript.js and the ScriptManager.ScriptMode property is set to ScriptMode.Debug, but CustomScript.debug.js does not exist on the site. Ссылки на скрипты в сборке возвращают версию выпуска, если отладочная версия не существует.References to scripts in an assembly return the release version if the debug version does not exist.

Примечание

Если атрибут элемента trueDeployment файла Machine. config имеет значение, то на веб-сайте используются окончательные версии клиентских скриптов. retailWhen the retail attribute of the deployment element of the Machine.config file is set to true, the release versions of client scripts are used throughout the Web site. Значения в свойствах и ScriptReference. скриптмоде игнорируются. ScriptManager.ScriptMode ScriptModeThe ScriptMode values in the ScriptManager.ScriptMode and ScriptReference.ScriptMode properties are ignored.

Применяется к