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 控件中，在网页上使用客户端脚本的发布版本。

示例

以下示例显示了一个页面，其中脚本版本在 控件中以声明方式设置为 Release，但在 控件中ScriptManagerName以声明方式将一个名为 CustomClient.js 的脚本设置为 Debug。

<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 文件的 deployment 元素的 属性设置为 true时，将在整个网站中使用客户端脚本的发布版本。 ScriptMode和 ScriptReference.ScriptMode 属性中的ScriptManager.ScriptMode值将被忽略。