ScriptManager.RegisterStartupScript Metódus

Definíció

Névtér:

System.Web.UI

Szerelvény:

System.Web.Extensions.dll

Regisztrál egy indítási szkriptblokkot a ScriptManager vezérlővel, és hozzáadja a szkriptblokkot a laphoz.

Túlterhelések

Name	Description
RegisterStartupScript(Control, Type, String, String, Boolean)	Regisztrál egy indítási szkriptblokkot egy vezérlőelemhez, amely egy UpdatePanel vezérlőn belül ScriptManager található, és hozzáadja a szkriptblokkot a laphoz.
RegisterStartupScript(Page, Type, String, String, Boolean)	Regisztrál egy indítási szkriptblokkot minden aszinkron utómunkához a ScriptManager vezérlővel, és hozzáadja a szkriptblokkot a laphoz.

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

Regisztrál egy indítási szkriptblokkot egy vezérlőelemhez, amely egy UpdatePanel vezérlőn belül ScriptManager található, és hozzáadja a szkriptblokkot a laphoz.

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)

Paraméterek

control

Control

Az ügyfélszkriptblokkot regisztráló vezérlő.

type

Type

Az ügyfélszkriptblokk típusa. Ezt a paramétert általában a typeof operátor (C#) vagy a GetType operátor (Visual Basic) használatával adhatja meg a szkriptet regisztráló vezérlő típusának lekéréséhez.

key

String

A szkriptblokk egyedi azonosítója.

script

String

A regisztrálandó szkript.

addScriptTags

Boolean

true a szkriptblokkot <script></script> és címkéket is mellékelje; ellenkező esetben false.

Kivételek

ArgumentNullException

control az null.

-vagy-

type az null.

ArgumentException

control nincs a lap vezérlőfája.

Megjegyzések

A RegisterStartupScript metódussal regisztrálhat egy indítási szkriptblokkot egy olyan laphoz, amely kompatibilis a részleges oldalmegjelenítéssel, és amely nem rendelkezik Microsoft Ajax-kódtár-függőségekkel. Az ezzel a módszerrel regisztrált indítási szkriptblokkokat a rendszer csak akkor küldi el a lapra, ha a blokkot regisztráló vezérlő egy UpdatePanel frissítendő vezérlőn belül van. Ha minden aszinkron utóvisszavételkor regisztrálni szeretne egy indítási szkriptblokkot, használja ennek a metódusnak a RegisterStartupScript(Page, Type, String, String, Boolean) túlterhelését.

Ha olyan indítási szkriptet szeretne regisztrálni, amely nem vonatkozik részleges oldalfrissítésre, és ha csak egyszer szeretné regisztrálni a szkriptet a kezdeti lapmegjelenítés során, használja az RegisterStartupScriptClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManagerClientScript oldal tulajdonságából kaphatja meg.

A metódus által RegisterStartupScript renderelt szkriptblokk a lap betöltésekor, de az oldal ügyféleseményének onload létrehozása előtt fut. Az indítási szkriptblokkok a renderelt ASP.NET oldal alján találhatók, a </form> címke előtt.

A használatával RegisterStartupScript regisztrált indítási szkriptblokkok nem garantáltan ugyanabban a sorrendben jelennek meg, amelyben regisztrálva vannak. Ha az indítási szkriptblokkok sorrendje fontos, használjon egy StringBuilder objektumot a szkriptblokkok egyetlen sztringben való gyűjtéséhez, majd regisztrálja őket egyetlen indítási szkriptként.

Lásd még

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

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

Regisztrál egy indítási szkriptblokkot minden aszinkron utómunkához a ScriptManager vezérlővel, és hozzáadja a szkriptblokkot a laphoz.

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)

Paraméterek

page

Page

Az ügyfélszkriptblokkot regisztráló lapobjektum.

type

Type

Az ügyfélszkriptblokk típusa. Ezt a paramétert általában a typeof operátor (C#) vagy a GetType operátor (Visual Basic) használatával adhatja meg a szkriptet regisztráló vezérlő típusának lekéréséhez.

key

String

A szkriptblokk egyedi azonosítója.

script

String

A regisztrálandó szkript.

addScriptTags

Boolean

true a szkriptblokkot <script></script> és címkéket is mellékelje; ellenkező esetben false.

Megjegyzések

Ezzel a módszerrel regisztrálhat egy indítási szkriptblokkot, amely minden alkalommal szerepel, amikor aszinkron visszavétel történik. Ha szkriptblokkot szeretne regisztrálni egy vezérlőn belüli UpdatePanel vezérlőelemhez, hogy a szkriptblokk csak a UpdatePanel vezérlő frissítésekor legyen regisztrálva, használja ennek a metódusnak a RegisterStartupScript(Control, Type, String, String, Boolean) túlterhelését.

Ha olyan indítási szkriptet szeretne regisztrálni, amely nem vonatkozik részleges oldalfrissítésre, és ha csak egyszer szeretné regisztrálni a szkriptet a kezdeti lapmegjelenítés során, használja az RegisterStartupScriptClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManagerClientScript oldal tulajdonságából kaphatja meg.

Lásd még

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