ScriptMode Enum

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.Extensions.dll

Menentukan apakah ScriptManager objek dan ScriptReference merujuk ke versi debug atau rilis skrip klien.

public enum class ScriptMode

public enum ScriptMode

type ScriptMode = 

Public Enum ScriptMode

Warisan

Object

ValueType

Enum

ScriptMode

Bidang

Auto	0	ScriptManager Dalam kontrol, versi skrip klien yang akan digunakan ditentukan pada durasi berdasarkan elemen kompilasi> tingkat< aplikasi dari file Web.config, kecuali jika ditimpa dalam instans ScriptReference kontrol. ScriptReference Dalam kontrol, ketika diterapkan ke file skrip mandiri, Auto setara dengan Release. Saat diterapkan ke referensi skrip dalam rakitan, Auto setara dengan Inherit.
Debug	2	ScriptManager Dalam kontrol, versi debug skrip klien digunakan di halaman Web kecuali ditimpa dalam instans ScriptReference kontrol. ScriptReference Dalam kontrol, versi debug skrip klien digunakan pada halaman Web.
Inherit	1	ScriptManager Dalam kontrol , Inherit setara dengan Auto. ScriptReference Dalam kontrol, ScriptMode nilai dari ScriptManager menentukan versi skrip klien mana yang akan digunakan.
Release	3	ScriptManager Dalam kontrol, versi rilis skrip klien digunakan di halaman Web kecuali ditimpa dengan mengatur ScriptMode properti ScriptReference instans ke Debug. ScriptReference Dalam kontrol, versi rilis skrip klien digunakan di halaman Web.

Contoh

Contoh berikut menunjukkan halaman di mana versi skrip secara deklaratif diatur ke Rilis dalam ScriptManager kontrol, tetapi satu skrip bernama CustomClient.js secara deklaratif diatur ke Debug dalam Name kontrol.

<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>

Keterangan

Enumerasi ScriptMode menyediakan nilai untuk mengatur versi skrip klien untuk digunakan pada halaman Web. Nilai enumerasi dapat diterapkan ke ScriptManager.ScriptMode properti atau ke properti ScriptReference.ScriptMode . Objek ScriptManager mengatur versi untuk semua skrip di halaman kecuali jika ditimpa oleh ScriptReference objek. Objek ScriptReference mengatur versi untuk skrip tertentu.

Nilai ScriptMode.Auto menghasilkan hasil yang berbeda tergantung pada apakah itu mengacu pada file skrip mandiri atau ke file skrip yang disematkan sebagai sumber daya dalam rakitan. File skrip mandiri ditentukan dengan properti ScriptReference.Path . Referensi perakitan harus diakses melalui Name properti dan Assembly . Hasil untuk ScriptMode.Auto nilai adalah sebagai berikut:

• Ketika diterapkan ke file skrip mandiri di mana properti [ScriptReference.Path]Path ditentukan, ScriptMode.Auto nilainya setara dengan ScriptMode.Release.

• Ketika diterapkan ke referensi skrip dalam rakitan, ScriptMode.Auto setara dengan ScriptMode.Inherit. Ketika hanya Name ditentukan, skrip digunakan untuk mereferensikan skrip. Ketika Name dan properti [ScriptReference.Path]Path ditentukan, properti [ScriptReference.Path]Path digunakan alih-alih Name, tetapi ScriptMode.Auto nilainya masih setara dengan ScriptMode.Inherit.

Kesalahan dilemparkan jika versi skrip yang diminta tidak ada. Misalnya, kesalahan dilemparkan jika referensi dibuat ke file skrip mandiri yang diberi nama CustomScript.js dan ScriptManager.ScriptMode properti diatur ke ScriptMode.Debug, tetapi CustomScript.debug.js tidak ada di situs. Referensi ke skrip dalam rakitan mengembalikan versi rilis jika versi debug tidak ada.

Catatan

retail Ketika atribut elemen penyebaran file Machine.config diatur ke true, versi rilis skrip klien digunakan di seluruh situs Web. Nilai ScriptMode dalam ScriptManager.ScriptMode properti dan ScriptReference.ScriptMode diabaikan.