Compartir vía

ScriptManager.RegisterArrayDeclaration Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.Extensions.dll

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.

Sobrecargas

RegisterArrayDeclaration(Control, String, String)

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.
RegisterArrayDeclaration(Page, String, String)

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.

RegisterArrayDeclaration(Control, String, String)

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.

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)

Parámetros

control
Control

Control que registra la matriz.

arrayName
String

Nombre de la matriz que se va a registrar.

arrayValue
String

Valor o valores de la matriz que se va a registrar.

Excepciones

ArgumentNullException

arrayName es null.

Comentarios

Use el RegisterArrayDeclaration método para registrar una matriz de scripts de cliente compatible con la representación parcial de páginas y que no tenga dependencias de la biblioteca de Microsoft Ajax. Este método registra la matriz cuando control representa un control que está dentro de un UpdatePanel control que se está actualizando. Para registrar una matriz cada vez que se produce una postback asincrónica, use la RegisterArrayDeclaration(Page, String, String) sobrecarga de este método.

Si desea registrar una matriz que no pertenece a actualizaciones parciales de páginas y si desea registrar la matriz solo una vez durante la representación de página inicial, use el RegisterArrayDeclaration método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

El RegisterArrayDeclaration método determina si ya está registrada una matriz con el nombre especificado en el arrayName parámetro . Si es así, el método agrega los valores especificados en arrayValue. Dado que la matriz que se va a registrar se basa en la ArrayList clase , se permiten duplicados. Si no existe una matriz registrada con el nombre de , arrayName se crea la matriz y se agregan los valores de arrayValue .

Para incluir literales de cadena en la matriz, use comillas simples (') o comillas dobles con escape (\") en arrayValue.

Tenga en cuenta que JavaScript trata una coma (,) como delimitador en una matriz. Puede especificar varios valores de matriz pasando una cadena delimitada por comas en arrayValue. Separar dos elementos con una coma en arrayValue equivale a llamar al RegisterArrayDeclaration método dos veces, una vez para cada elemento.

Consulte también

Se aplica a

RegisterArrayDeclaration(Page, String, String)

Registra una declaración de matriz de ECMAScript (JavaScript) con el control ScriptManager para usarlo con un control que está dentro de un control UpdatePanel y, a continuación, agrega la matriz a la página.

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)

Parámetros

page
Page

Objeto de página que registra la matriz.

arrayName
String

Nombre de la matriz que se va a registrar.

arrayValue
String

Valor o valores de la matriz que se va a registrar.

Excepciones

ArgumentNullException

arrayName es null.

Comentarios

Use el RegisterArrayDeclaration método para registrar una matriz de scripts de cliente compatible con la representación parcial de páginas y que no tenga dependencias de la biblioteca de Microsoft Ajax. Este método registra la matriz cada vez que se produce un postback asincrónico. Para registrar una matriz para un control que se encuentra dentro de un UpdatePanel control para que la matriz solo se registre cuando se actualice el panel, use la RegisterArrayDeclaration(Control, String, String) sobrecarga de este método.

Si desea registrar una matriz que no pertenece a actualizaciones parciales de páginas y si desea registrar la matriz solo una vez durante la representación de página inicial, use el RegisterArrayDeclaration método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

Consulte también

Se aplica a