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

ScriptManager コントロールでは、Inherit は Auto と同じです。 ScriptReference コントロールでは、ScriptMode の ScriptManager 値により、使用されるクライアント スクリプトのバージョンが決定されます。
Release 3

ScriptManager コントロールでは、ScriptMode インスタンスの ScriptReference プロパティが Debug でオーバーライドされるまで、クライアント スクリプトのリリース バージョンが Web ページ上で使用されます。 ScriptReference コントロールでは、リリース バージョンのクライアント スクリプトが Web ページで使用されます。

例

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

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

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

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

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

注意

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

適用対象