共用方式為


ScriptMode 列舉

定義

指定 ScriptManagerScriptReference 物件是否參考用戶端指令碼的偵錯或發行版本。

public enum class ScriptMode
public enum ScriptMode
type ScriptMode = 
Public Enum ScriptMode
繼承
ScriptMode

欄位

Auto 0

ScriptManager 控制項中,要使用的用戶端指令碼版本是在執行階段根據 Web.config 檔案的應用程式層級 <compilation> 項目來決定,除非已在 ScriptReference 控制項的執行個體中覆寫。 在 ScriptReference 控制項中,當套用至獨立的指令碼檔案時,Auto 相當於 Release。 當套用至組件中的指令碼參考時,Auto 相當於 Inherit

Debug 2

ScriptManager 控制項中,會在網頁上使用用戶端指令碼的偵錯版本,除非在 ScriptReference 控制項的執行個體中覆寫。 在 ScriptReference 控制項中,會在網頁上使用用戶端指令碼的偵錯版本。

Inherit 1

在控制項中ScriptManagerInherit相當於 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 屬性來定義。 必須透過 NameAssembly 屬性存取元件參考。 值的結果 ScriptMode.Auto 如下所示:

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

注意

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

適用於