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。在控件中ScriptReferenceScriptMode，的值ScriptManager會決定要使用的用戶端腳本版本。
Release	3	在 ScriptManager 控制項中，會在網頁上使用用戶端指令碼的發行版本，除非透過將 ScriptReference 執行個體的 ScriptMode 屬性設定為 Debug 而予以覆寫。 在 ScriptReference 控制項中，會在網頁上使用用戶端指令碼的發行版本。

範例

下列範例顯示腳本版本在控件中 ScriptManager 以宣告方式設定為 Release 的頁面，但名為 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]PathPath 屬性，而不是 Name，但ScriptMode.Auto值仍然相當於 ScriptMode.Inherit。

如果要求的腳本版本不存在，就會擲回錯誤。 例如，如果對名為 CustomScript.js ScriptManager.ScriptMode 且 屬性設定 ScriptMode.Debug為 的獨立腳本檔案進行參考，但網站中不存在 CustomScript.debug.js，則會擲回錯誤。 如果偵錯版本不存在，元件中的腳本參考會傳回發行版本。

注意

retail當 Machine.config 檔案之部署專案的 屬性設定true為 時，用戶端腳本的發行版本會在整個網站上使用。 ScriptMode會忽略和 ScriptReference.ScriptMode 屬性中的ScriptManager.ScriptMode值。