ScriptManager.RegisterArrayDeclaration Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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
Si applica a
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
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.