ScriptManager.RegisterStartupScript Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.Extensions.dll

Mendaftarkan blok skrip startup dengan ScriptManager kontrol dan menambahkan blok skrip ke halaman.

Overload

Nama	Deskripsi
RegisterStartupScript(Control, Type, String, String, Boolean)	Mendaftarkan blok skrip startup untuk kontrol yang ada di dalam dengan UpdatePanel menggunakan ScriptManager kontrol, dan menambahkan blok skrip ke halaman.
RegisterStartupScript(Page, Type, String, String, Boolean)	Mendaftarkan blok skrip startup untuk setiap postback asinkron dengan ScriptManager kontrol dan menambahkan blok skrip ke halaman.

RegisterStartupScript(Control, Type, String, String, Boolean)

Mendaftarkan blok skrip startup untuk kontrol yang ada di dalam dengan UpdatePanel menggunakan ScriptManager kontrol, dan menambahkan blok skrip ke halaman.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript(System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parameter

control

Control

Kontrol yang mendaftarkan blok skrip klien.

type

Type

Jenis blok skrip klien. Parameter ini biasanya ditentukan dengan menggunakan operator typeof (C#) atau operator GetType (Visual Basic) untuk mengambil jenis kontrol yang mendaftarkan skrip.

key

String

Pengidentifikasi unik untuk blok skrip.

script

String

Skrip untuk mendaftar.

addScriptTags

Boolean

true untuk mengapit blok skrip dengan <script> dan </script> tag; jika tidak, false.

Pengecualian

ArgumentNullException

control adalah null.

-atau-

type adalah null.

ArgumentException

control tidak ada di pohon kontrol halaman.

Keterangan

Anda menggunakan RegisterStartupScript metode untuk mendaftarkan blok skrip startup untuk halaman yang kompatibel dengan penyajian halaman parsial dan yang tidak memiliki dependensi Pustaka Microsoft Ajax. Blok skrip startup yang didaftarkan dengan menggunakan metode ini dikirim ke halaman hanya ketika kontrol yang mendaftarkan blok berada di dalam UpdatePanel kontrol yang sedang diperbarui. Untuk mendaftarkan blok skrip startup setiap kali terjadi postback asinkron, gunakan RegisterStartupScript(Page, Type, String, String, Boolean) kelebihan beban metode ini.

Jika Anda ingin mendaftarkan skrip startup yang tidak berkaitan dengan pembaruan halaman parsial, dan jika Anda ingin mendaftarkan skrip hanya satu kali selama penyajian halaman awal, gunakan RegisterStartupScript metode ClientScriptManager kelas . Anda bisa mendapatkan referensi ke ClientScriptManager objek dari ClientScript properti halaman.

Blok skrip yang dirender oleh RegisterStartupScript metode dijalankan ketika halaman selesai dimuat tetapi sebelum peristiwa klien onload halaman dinaikkan. Blok skrip startup terletak di bagian bawah halaman ASP.NET yang dirender tepat sebelum </form> tag.

Blok skrip startup yang didaftarkan dengan menggunakan RegisterStartupScript tidak dijamin output dalam urutan yang sama di mana mereka terdaftar. Jika urutan blok skrip startup penting, gunakan StringBuilder objek untuk mengumpulkan blok skrip dalam satu string, lalu daftarkan semuanya sebagai skrip startup tunggal.

Lihat juga

• RegisterStartupScript(Page, Type, String, String, Boolean)

RegisterStartupScript(Page, Type, String, String, Boolean)

Mendaftarkan blok skrip startup untuk setiap postback asinkron dengan ScriptManager kontrol dan menambahkan blok skrip ke halaman.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript(System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parameter

page

Page

Objek halaman yang mendaftarkan blok skrip klien.

type

Type

Jenis blok skrip klien. Parameter ini biasanya ditentukan dengan menggunakan operator typeof (C#) atau operator GetType (Visual Basic) untuk mengambil jenis kontrol yang mendaftarkan skrip.

key

String

Pengidentifikasi unik untuk blok skrip.

script

String

Skrip untuk mendaftar.

addScriptTags

Boolean

true untuk mengapit blok skrip dengan <script> dan </script> tag; jika tidak, false.

Keterangan

Anda menggunakan metode ini untuk mendaftarkan blok skrip startup yang disertakan setiap kali terjadi postback asinkron. Untuk mendaftarkan blok skrip untuk kontrol yang berada di dalam UpdatePanel kontrol sehingga blok skrip didaftarkan hanya ketika UpdatePanel kontrol diperbarui, gunakan RegisterStartupScript(Control, Type, String, String, Boolean) kelebihan beban metode ini.

Jika Anda ingin mendaftarkan skrip startup yang tidak berkaitan dengan pembaruan halaman parsial, dan jika Anda ingin mendaftarkan skrip hanya satu kali selama penyajian halaman awal, gunakan RegisterStartupScript metode ClientScriptManager kelas . Anda bisa mendapatkan referensi ke ClientScriptManager objek dari ClientScript properti halaman.

Lihat juga

• RegisterStartupScript(Control, Type, String, String, Boolean)