ScriptManager.RegisterArrayDeclaration ScriptManager.RegisterArrayDeclaration ScriptManager.RegisterArrayDeclaration Method

Определение

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.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)

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.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)

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.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)

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.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

Параметры

control
Control Control Control

Элемент управления, регистрирующий массив.The control that is registering the array.

arrayName
String String String

Имя регистрируемого массива.The name of the array to register.

arrayValue
String String String

Значение или значения массива для регистрации.The array value or values to register.

Исключения

arrayNamenull.arrayName is null.

Комментарии

RegisterArrayDeclaration Метод используется для регистрации массива клиентского скрипта, совместимого с частичной отрисовкой страницы и не имеющего зависимостей библиотеки Microsoft AJAX.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. Этот метод регистрирует массив, когда control представляет элемент управления UpdatePanel внутри обновляемого элемента управления.This method registers the array when control represents a control that is inside an UpdatePanel control that is being updated. Чтобы зарегистрировать массив при каждом возникновении асинхронной обратной передачи, используйте RegisterArrayDeclaration(Page, String, String) перегрузку этого метода.To register an array every time that an asynchronous postback occurs, use the RegisterArrayDeclaration(Page, String, String) overload of this method.

Если требуется зарегистрировать массив, который не относится к частичным обновлениям страницы, и если требуется зарегистрировать массив только один раз во время первоначальной отрисовки страницы, используйте RegisterArrayDeclaration метод ClientScriptManager класса.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. Ссылку на ClientScriptManager объект можно получить ClientScript из свойства страницы.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Метод определяет, уже зарегистрирован ли массив с именем, указанным arrayName в параметре. RegisterArrayDeclarationThe RegisterArrayDeclaration method determines whether an array with the name that is specified in the arrayName parameter is already registered. Если это так, метод добавляет значения, указанные в arrayValueпараметре.If so, the method adds the values specified in arrayValue. Поскольку регистрируемый массив основан на ArrayList классе, допускаются дубликаты.Because the array to be registered is based on the ArrayList class, duplicates are allowed. Если зарегистрированный массив с именем в arrayName не существует, создается массив и добавляются значения в arrayValue него.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.

Чтобы включить в массив строковые литералы, используйте одинарные кавычки (') или экранированные двойные\кавычки ( arrayValue") в.To include string literals in the array, use single quotation marks (') or escaped double quotation marks (\") in arrayValue.

Обратите внимание, что JavaScript обрабатывает запятую (,) как разделитель в массиве.Note that JavaScript treats a comma (,) as a delimiter in an array. Можно указать несколько значений массива, передав строку с разделителями-запятыми arrayValueв.You can specify multiple array values by passing a comma-delimited string in arrayValue. Разделение двух элементов запятыми в arrayValue эквивалентно RegisterArrayDeclaration вызову метода два раза, один раз для каждого элемента.Separating two items with a comma in arrayValue is equivalent to calling the RegisterArrayDeclaration method two times, one time for each item.

Дополнительно

RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String) RegisterArrayDeclaration(Page, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.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

Параметры

page
Page Page Page

Объект страницы, регистрирующий массив.The page object that is registering the array.

arrayName
String String String

Имя регистрируемого массива.The name of the array to register.

arrayValue
String String String

Значение или значения массива для регистрации.The array value or values to register.

Исключения

arrayNamenull.arrayName is null.

Комментарии

RegisterArrayDeclaration Метод используется для регистрации массива клиентского скрипта, совместимого с частичной отрисовкой страницы и не имеющего зависимостей библиотеки Microsoft AJAX.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. Этот метод регистрирует массив при каждом возникновении асинхронной обратной передачи.This method registers the array every time that an asynchronous postback occurs. Чтобы зарегистрировать массив для элемента управления, находящегося внутри UpdatePanel элемента управления таким образом, чтобы массив был зарегистрирован только при обновлении панели, RegisterArrayDeclaration(Control, String, String) используйте перегрузку этого метода.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.

Если требуется зарегистрировать массив, который не относится к частичным обновлениям страницы, и если требуется зарегистрировать массив только один раз во время первоначальной отрисовки страницы, используйте RegisterArrayDeclaration метод ClientScriptManager класса.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. Ссылку на ClientScriptManager объект можно получить ClientScript из свойства страницы.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Дополнительно

Применяется к