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 コントロールでは、ScriptReference コントロールのインスタンスでオーバーライドされない限り、アプリケーション レベルの web.config file の <compilation> 要素に基づいて、使用するクライアント スクリプトのバージョンが実行時に決定されます。 ScriptReference コントロールでは、スタンドアロン スクリプト ファイルに適用された場合、Auto は Release と同じです。 アセンブリ内のスクリプト参照に適用された場合は、Auto 値は Inherit と同じになります。
Debug	2	ScriptManager コントロールでは、ScriptReference コントロールのインスタンスでオーバーライドされるまで、クライアント スクリプトのデバッグ バージョンが Web ページ上で使用されます。 ScriptReference コントロールでは、クライアント スクリプトのデバッグ バージョンが Web ページ上で使用されます。
Inherit	1	コントロールでは、 ScriptManagerInherit は とAuto同じです。コントロールではScriptReference、 のScriptManager値によってScriptMode、使用するクライアント スクリプトのバージョンが決まります。
Release	3	ScriptManager コントロールでは、ScriptMode インスタンスの ScriptReference プロパティが Debug でオーバーライドされるまで、クライアント スクリプトのリリース バージョンが Web ページ上で使用されます。 ScriptReference コントロールでは、リリース バージョンのクライアント スクリプトが Web ページで使用されます。

例

次の例は、スクリプト のバージョンがコントロールで ScriptManager 宣言によって Release に設定されているページを示していますが、CustomClient.js という名前の 1 つのスクリプトがコントロールで Name 宣言によって 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 、Web ページで使用するクライアント スクリプトのバージョンを設定するための値を提供します。 列挙値は、 プロパティまたは ScriptReference.ScriptMode プロパティに適用ScriptManager.ScriptModeできます。 オブジェクトは ScriptManager 、オブジェクトによってオーバーライドされない限り、ページ上のすべてのスクリプトのバージョンを ScriptReference 設定します。 オブジェクトは ScriptReference 、特定のスクリプトのバージョンを設定します。

値は ScriptMode.Auto 、スタンドアロン スクリプト ファイルを参照するか、アセンブリ内のリソースとして埋め込まれているスクリプト ファイルを参照するかによって異なる結果を生成します。 スタンドアロン スクリプト ファイルは ScriptReference.Path プロパティで定義されます。 アセンブリ参照には、 プロパティと Assembly プロパティを使用してアクセスするName必要があります。 値の ScriptMode.Auto 結果は次のとおりです。

• [ScriptReference.Path]Path プロパティが指定されているスタンドアロン スクリプト ファイルに適用される場合、 ScriptMode.Auto 値は と ScriptMode.Release同じです。

• アセンブリ内のスクリプト参照に適用される場合、 ScriptMode.Auto は と ScriptMode.Inherit同じです。 のみを Name 指定すると、スクリプトを参照するために使用されます。 と [ScriptReference.Path] プロパティの両方が指定されている場合Nameは、 の代わりに Name[ScriptReference.Path]Path プロパティが使用されますがScriptMode.Auto、値は と同じですScriptMode.Inherit。Path

要求されたバージョンのスクリプトが存在しない場合は、エラーがスローされます。 たとえば、CustomScript.js ScriptManager.ScriptMode という名前のスタンドアロン スクリプト ファイルへの参照が行われ、 プロパティが に ScriptMode.Debug設定されていても、サイトに CustomScript.debug.js が存在しない場合、エラーがスローされます。 アセンブリ内のスクリプトへの参照は、デバッグ バージョンが存在しない場合にリリース バージョンを返します。

注意

retailMachine.config ファイルの展開要素の属性が にtrue設定されている場合、リリース バージョンのクライアント スクリプトが Web サイト全体で使用されます。 および ScriptReference.ScriptMode プロパティのScriptManager.ScriptMode値はScriptMode無視されます。