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 文件的应用程序级 <compilation> 元素在运行时确定要使用的客户端脚本版本，除非它已在 ScriptReference 控件的实例中重写。 在 ScriptReference 控件中，当 Auto 应用于独立脚本文件时，它等效于 Release。 应用于程序集中的脚本引用时，Auto 等效于 Inherit。
Debug	2	在 ScriptManager 控件中，在网页上使用客户端脚本的调试版本，除非该版本在 ScriptReference 控件实例中进行了重写。 在 ScriptReference 控件中，在网页上使用客户端脚本的调试版本。
Inherit	1	在 ScriptManager 控件中，Inherit 等效于 Auto。 在 ScriptReference 控件中，来自 ScriptMode 的 ScriptManager 值决定要使用的客户端脚本的版本。
Release	3	在 ScriptManager 控件中，在网页上使用客户端脚本的发布版本，除非通过将 ScriptReference 实例的 ScriptMode 属性设置为 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 指定时，它用于引用脚本。 当指定 [ScriptReference.Path] 属性时Name，将使用 [ScriptReference.Path]Path 属性而不是 Name，但ScriptMode.Auto该值仍等效ScriptMode.Inherit。Path

如果请求的脚本版本不存在，则会引发错误。 例如，如果对名为CustomScript.js ScriptManager.ScriptMode 且属性设置为 ScriptMode.Debug的独立脚本文件的引用，但站点上不存在CustomScript.debug.js，则会引发错误。 如果调试版本不存在，则对程序集中的脚本的引用将返回发布版本。

备注

将 retail Machine.config文件的 部署 元素的属性设置为 true时，客户端脚本的发布版本将在整个网站上使用。 ScriptMode忽略和 ScriptReference.ScriptMode 属性中的ScriptManager.ScriptMode值。