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 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] 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 值。