ScriptManager.RegisterArrayDeclaration Metódus

Definíció

Névtér:

System.Web.UI

Szerelvény:

System.Web.Extensions.dll

Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.

Túlterhelések

Name	Description
RegisterArrayDeclaration(Control, String, String)	Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.
RegisterArrayDeclaration(Page, String, String)	Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.

RegisterArrayDeclaration(Control, String, String)

Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.

public:
 static void RegisterArrayDeclaration(System::Web::UI::Control ^ control, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration(System.Web.UI.Control control, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Control * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (control As Control, arrayName As String, arrayValue As String)

Paraméterek

control

Control

A tömböt regisztráló vezérlő.

arrayName

String

A regisztrálandó tömb neve.

arrayValue

String

A regisztrálandó tömbérték vagy értékek.

Kivételek

ArgumentNullException

arrayName az null.

Megjegyzések

A RegisterArrayDeclaration metódussal olyan ügyfélszkripttömböt regisztrálhat, amely kompatibilis a részleges oldalmegjelenítéssel, és amely nem rendelkezik Microsoft Ajax-kódtár-függőségekkel. Ez a metódus akkor regisztrálja a tömböt, ha control egy frissített vezérlőelemen belüli UpdatePanel vezérlőelemet jelöl. Ha minden alkalommal regisztrálni szeretne egy tömböt, amikor aszinkron visszavétel történik, használja ennek a metódusnak a RegisterArrayDeclaration(Page, String, String) túlterhelését.

Ha olyan tömböt szeretne regisztrálni, amely nem tartozik a részleges oldalfrissítések közé, és csak egyszer szeretné regisztrálni a tömböt a kezdeti lapmegjelenítés során, használja az RegisterArrayDeclarationClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManagerClientScript oldal tulajdonságából kaphatja meg.

A RegisterArrayDeclaration metódus meghatározza, hogy a paraméterben arrayName megadott névvel rendelkező tömb már regisztrálva van-e. Ha igen, a metódus hozzáadja a megadott értékeket.arrayValue Mivel a regisztrálandó tömb az ArrayList osztályon alapul, az ismétlődések engedélyezettek. Ha a névvel rendelkező arrayName regisztrált tömb nem létezik, a rendszer létrehozza a tömböt, és hozzáadja a benne lévő arrayValue értékeket.

Ha sztringkonstansokat szeretne belefoglalni a tömbbe, használjon egyetlen idézőjelet (') vagy szökött kettős idézőjelet (\") a tömbben arrayValue.

Vegye figyelembe, hogy a JavaScript egy vesszőt (,) elválasztóként kezel egy tömbben. Több tömbértéket is megadhat, ha egy vesszővel tagolt sztringet ad át a fájlban arrayValue. Ha két vesszőt arrayValue tartalmazó elemet választ el egymástól, azzal egyenértékű, ha a RegisterArrayDeclaration metódust kétszer, minden elemhez egyszer meghívja.

Lásd még

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

Regisztrál egy ECMAScript (JavaScript) tömbdeklarációt a ScriptManager vezérlővel, amely egy vezérlőn belül UpdatePanel található vezérlővel használható, és hozzáadja a tömböt a laphoz.

public:
 static void RegisterArrayDeclaration(System::Web::UI::Page ^ page, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration(System.Web.UI.Page page, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Page * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (page As Page, arrayName As String, arrayValue As String)

Paraméterek

page

Page

A tömböt regisztráló lapobjektum.

arrayName

String

A regisztrálandó tömb neve.

arrayValue

String

A regisztrálandó tömbérték vagy értékek.

Kivételek

ArgumentNullException

arrayName az null.

Megjegyzések

A RegisterArrayDeclaration metódussal olyan ügyfélszkripttömböt regisztrálhat, amely kompatibilis a részleges oldalmegjelenítéssel, és amely nem rendelkezik Microsoft Ajax-kódtár-függőségekkel. Ez a metódus minden alkalommal regisztrálja a tömböt, amikor aszinkron utólagos visszaállítás történik. Ha egy vezérlőn belüli UpdatePanel vezérlőelemhez szeretne tömböt regisztrálni, hogy a tömb csak a panel frissítésekor legyen regisztrálva, használja a RegisterArrayDeclaration(Control, String, String) metódus túlterhelését.

Ha olyan tömböt szeretne regisztrálni, amely nem tartozik a részleges oldalfrissítések közé, és csak egyszer szeretné regisztrálni a tömböt a kezdeti lapmegjelenítés során, használja az RegisterArrayDeclarationClientScriptManager osztály metódusát. Az objektumra mutató hivatkozást az ClientScriptManagerClientScript oldal tulajdonságából kaphatja meg.

Lásd még

• RegisterArrayDeclaration(Control, String, String)