ScriptManager.RegisterArrayDeclaration ScriptManager.RegisterArrayDeclaration ScriptManager.RegisterArrayDeclaration Method

Definición

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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

Sobrecargas

RegisterArrayDeclaration(Control, String, String) RegisterArrayDeclaration(Control, String, String) 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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String) 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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterArrayDeclaration(Control, String, String) RegisterArrayDeclaration(Control, String, String) 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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

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

Parámetros

control
Control Control Control

Control que registra la matriz.The control that is registering the array.

arrayName
String String String

Nombre de la matriz que se va a registrar.The name of the array to register.

arrayValue
String String String

Valor o valores de matriz que se va a registrar.The array value or values to register.

Excepciones

Comentarios

Usa el RegisterArrayDeclaration método para registrar una matriz de script de cliente que sea compatible con la representación parcial de página y que no tiene ninguna dependencia de Microsoft Ajax Library.You use the RegisterArrayDeclaration method to register a client script array that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Este método registra la matriz cuando control representa un control que está dentro de un UpdatePanel control que se está actualizando.This method registers the array when control represents a control that is inside an UpdatePanel control that is being updated. Para registrar una matriz cada vez que se produce un postback asincrónico, utilice el RegisterArrayDeclaration(Page, String, String) sobrecarga de este método.To register an array every time that an asynchronous postback occurs, use the RegisterArrayDeclaration(Page, String, String) overload of this method.

Si desea registrar una matriz que no pertenecen a las actualizaciones parciales de página y, si desea registrar la matriz solo una vez durante la representación de página inicial, utilice el RegisterArrayDeclaration método de la ClientScriptManager clase.If you want to register an array that does not pertain to partial-page updates, and if you want to register the array only one time during initial page rendering, use the RegisterArrayDeclaration method of the ClientScriptManager class. Puede obtener una referencia a la ClientScriptManager objeto desde el ClientScript propiedad de la página.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

El RegisterArrayDeclaration método determina si una matriz con el nombre especificado en el arrayName parámetro ya está registrado.The RegisterArrayDeclaration method determines whether an array with the name that is specified in the arrayName parameter is already registered. Si es así, el método agrega los valores especificados en arrayValue.If so, the method adds the values specified in arrayValue. Dado que la matriz que se registrarán se basa en el ArrayList (clase), se permiten duplicados.Because the array to be registered is based on the ArrayList class, duplicates are allowed. Si una matriz registrada con el nombre en arrayName no existe, se crea la matriz y los valores de arrayValue se agregan a él.If a registered array with the name in arrayName does not exist, the array is created and the values in arrayValue are added to it.

Para incluir literales de cadena en la matriz, utilice comillas simples (') o comillas dobles de escape (\") en arrayValue.To include string literals in the array, use single quotation marks (') or escaped double quotation marks (\") in arrayValue.

Tenga en cuenta que JavaScript trata la coma (,) como delimitador de una matriz.Note that JavaScript treats a comma (,) as a delimiter in an array. Puede especificar varios valores de matriz pasando una cadena delimitada por comas en arrayValue.You can specify multiple array values by passing a comma-delimited string in arrayValue. Separar dos elementos con una coma en arrayValue equivale a llamar a la RegisterArrayDeclaration método dos veces, una vez por cada elemento.Separating two items with a comma in arrayValue is equivalent to calling the RegisterArrayDeclaration method two times, one time for each item.

Consulte también:

RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String) 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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

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

Parámetros

page
Page Page Page

Objeto de página que registra la matriz.The page object that is registering the array.

arrayName
String String String

Nombre de la matriz que se va a registrar.The name of the array to register.

arrayValue
String String String

Valor o valores de matriz que se va a registrar.The array value or values to register.

Excepciones

Comentarios

Usa el RegisterArrayDeclaration método para registrar una matriz de script de cliente que sea compatible con la representación parcial de página y que no tiene ninguna dependencia de Microsoft Ajax Library.You use the RegisterArrayDeclaration method to register a client script array that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Este método registra cada vez que se produce un postback asincrónico de la matriz.This method registers the array every time that an asynchronous postback occurs. Para registrar una matriz de un control que está dentro de un UpdatePanel para que se registre la matriz solo cuando se actualiza el panel de control, use el RegisterArrayDeclaration(Control, String, String) sobrecarga de este método.To register an array for a control that is inside an UpdatePanel control so that the array is registered only when the panel is updated, use the RegisterArrayDeclaration(Control, String, String) overload of this method.

Si desea registrar una matriz que no pertenecen a las actualizaciones parciales de página y, si desea registrar la matriz solo una vez durante la representación de página inicial, utilice el RegisterArrayDeclaration método de la ClientScriptManager clase.If you want to register an array that does not pertain to partial-page updates, and if you want to register the array only one time during initial page rendering, use the RegisterArrayDeclaration method of the ClientScriptManager class. Puede obtener una referencia a la ClientScriptManager objeto desde el ClientScript propiedad de la página.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Consulte también:

Se aplica a