ScriptManager.RegisterArrayDeclaration Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.

Overload

RegisterArrayDeclaration(Control, String, String)	Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.
RegisterArrayDeclaration(Page, String, String)	Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.

RegisterArrayDeclaration(Control, String, String)

Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.

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)

Parametri

control

Control

Controllo che registra la matrice.

arrayName

String

Nome della matrice da registrare.

arrayValue

String

Valore o valori della matrice da registrare.

Eccezioni

ArgumentNullException

arrayName è null.

Commenti

Si usa il RegisterArrayDeclaration metodo per registrare una matrice di script client compatibile con il rendering di pagine parziali e che non ha dipendenze di Microsoft Ajax Library. Questo metodo registra la matrice quando control rappresenta un controllo che si trova all'interno di un UpdatePanel controllo che viene aggiornato. Per registrare una matrice ogni volta che si verifica un postback asincrono, usare l'overload RegisterArrayDeclaration(Page, String, String) di questo metodo.

Se si vuole registrare una matrice che non riguarda gli aggiornamenti di pagina parziale e se si vuole registrare la matrice una sola volta durante il rendering iniziale della pagina, usare il RegisterArrayDeclaration metodo della ClientScriptManager classe. È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla proprietà ClientScript della pagina.

Il RegisterArrayDeclaration metodo determina se una matrice con il nome specificato nel arrayName parametro è già registrata. In tal caso, il metodo aggiunge i valori specificati in arrayValue. Poiché la matrice da registrare è basata sulla ArrayList classe, i duplicati sono consentiti. Se non esiste una matrice registrata con il nome in arrayName , la matrice viene creata e i valori in arrayValue vengono aggiunti.

Per includere valori letterali stringa nella matrice, usare virgolette singole (') o virgolette doppie escape (\") in arrayValue.

Si noti che JavaScript considera una virgola (,) come delimitatore in una matrice. È possibile specificare più valori di matrice passando una stringa delimitata da virgole in arrayValue. La separazione di due elementi con una virgola in arrayValue equivale a chiamare il RegisterArrayDeclaration metodo due volte, una volta per ogni elemento.

Vedi anche

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.

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)

Parametri

page

Page

Oggetto pagina che registra la matrice.

arrayName

String

Nome della matrice da registrare.

arrayValue

String

Valore o valori della matrice da registrare.

Eccezioni

ArgumentNullException

arrayName è null.

Commenti

Si usa il RegisterArrayDeclaration metodo per registrare una matrice di script client compatibile con il rendering di pagine parziali e che non ha dipendenze di Microsoft Ajax Library. Questo metodo registra la matrice ogni volta che si verifica un postback asincrono. Per registrare una matrice per un controllo all'interno di un UpdatePanel controllo in modo che la matrice venga registrata solo quando il pannello viene aggiornato, usare l'overload RegisterArrayDeclaration(Control, String, String) di questo metodo.

Se si vuole registrare una matrice che non riguarda gli aggiornamenti di pagina parziale e se si vuole registrare la matrice una sola volta durante il rendering iniziale della pagina, usare il RegisterArrayDeclaration metodo della ClientScriptManager classe. È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla proprietà ClientScript della pagina.

Vedi anche

• RegisterArrayDeclaration(Control, String, String)