Condividi tramite

ScriptManager.RegisterArrayDeclaration Metodo

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e aggiunge la matrice alla pagina.

Overload

Nome Descrizione
RegisterArrayDeclaration(Control, String, String)

Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e aggiunge la matrice alla pagina.
RegisterArrayDeclaration(Page, String, String)

Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e aggiunge la matrice alla pagina.

RegisterArrayDeclaration(Control, String, String)

Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo 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 della matrice o valori da registrare.

Eccezioni

ArgumentNullException

arrayName è null.

Commenti

Usare il RegisterArrayDeclaration metodo per registrare una matrice di script client compatibile con il rendering di pagine parziali e che non presenta dipendenze di Microsoft Ajax Library. Questo metodo registra la matrice quando control rappresenta un controllo che si trova all'interno di un UpdatePanel controllo da aggiornare. 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 a pagina parziale e se si desidera 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 ClientScript proprietà 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 , sono consentiti duplicati. 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 con caratteri di 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

Si applica a

RegisterArrayDeclaration(Page, String, String)

Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo 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 della matrice o valori da registrare.

Eccezioni

ArgumentNullException

arrayName è null.

Commenti

Usare il RegisterArrayDeclaration metodo per registrare una matrice di script client compatibile con il rendering di pagine parziali e che non presenta 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 a pagina parziale e se si desidera 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 ClientScript proprietà della pagina.

Vedi anche

Si applica a