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 свойства страницы.

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

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