Поделиться через

ScriptManager.RegisterArrayDeclaration Метод

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.Extensions.dll

Регистрирует объявление массива ECMAScript (JavaScript) с элементом управления для использования с ScriptManager элементом управления, который находится внутри UpdatePanel элемента управления, и добавляет массив на страницу.

Перегрузки

Имя Описание
RegisterArrayDeclaration(Control, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с элементом управления для использования с ScriptManager элементом управления, который находится внутри UpdatePanel элемента управления, и добавляет массив на страницу.
RegisterArrayDeclaration(Page, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с элементом управления для использования с ScriptManager элементом управления, который находится внутри UpdatePanel элемента управления, и добавляет массив на страницу.

RegisterArrayDeclaration(Control, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с элементом управления для использования с ScriptManager элементом управления, который находится внутри UpdatePanel элемента управления, и добавляет массив на страницу.

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)

Параметры

control
Control

Элемент управления, регистрирующий массив.

arrayName
String

Имя массива для регистрации.

arrayValue
String

Значение или значения массива для регистрации.

Исключения

ArgumentNullException

arrayName равно null.

Комментарии

Метод используется RegisterArrayDeclaration для регистрации массива клиентских скриптов, совместимого с частичной отрисовкой страниц и не зависимостей библиотеки Microsoft Ajax. Этот метод регистрирует массив при control представлении элемента управления, который находится внутри обновляемого UpdatePanel элемента управления. Чтобы регистрировать массив при каждом возникновении асинхронной обратной передачи, используйте RegisterArrayDeclaration(Page, String, String) перегрузку этого метода.

Если вы хотите зарегистрировать массив, который не относится к обновлениям частичной страницы, и если вы хотите зарегистрировать массив только один раз во время отрисовки начальной ClientScriptManager страницы, используйте RegisterArrayDeclaration метод класса. Ссылку на ClientScriptManager объект можно получить из ClientScript свойства страницы.

Метод RegisterArrayDeclaration определяет, зарегистрирован ли массив с именем, указанным в параметре arrayName . Если да, метод добавляет значения, указанные в arrayValue. Так как зарегистрированный массив основан на ArrayList классе, дубликаты допускаются. Если зарегистрированный массив с именем arrayName не существует, создается массив и в него добавляются значения arrayValue .

Чтобы включить строковые литералы в массив, используйте одинарные кавычки (') или экранированные двойные кавычки (\") в arrayValue.

Обратите внимание, что JavaScript обрабатывает запятую (,) как разделитель в массиве. Можно указать несколько значений массива, передав строку с разделителями-запятыми в arrayValue. Разделение двух элементов с запятой arrayValue эквивалентно вызову RegisterArrayDeclaration метода два раза, один раз для каждого элемента.

См. также раздел

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

RegisterArrayDeclaration(Page, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с элементом управления для использования с ScriptManager элементом управления, который находится внутри UpdatePanel элемента управления, и добавляет массив на страницу.

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)

Параметры

page
Page

Объект страницы, регистрирующий массив.

arrayName
String

Имя массива для регистрации.

arrayValue
String

Значение или значения массива для регистрации.

Исключения

ArgumentNullException

arrayName равно null.

Комментарии

Метод используется RegisterArrayDeclaration для регистрации массива клиентских скриптов, совместимого с частичной отрисовкой страниц и не зависимостей библиотеки Microsoft Ajax. Этот метод регистрирует массив при каждом возникновении асинхронной обратной передачи. Чтобы зарегистрировать массив для элемента управления, который находится внутри UpdatePanel элемента управления, чтобы массив регистрировался только при обновлении панели, используйте RegisterArrayDeclaration(Control, String, String) перегрузку этого метода.

Если вы хотите зарегистрировать массив, который не относится к обновлениям частичной страницы, и если вы хотите зарегистрировать массив только один раз во время отрисовки начальной ClientScriptManager страницы, используйте RegisterArrayDeclaration метод класса. Ссылку на ClientScriptManager объект можно получить из ClientScript свойства страницы.

См. также раздел

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