ScriptManager.RegisterArrayDeclaration Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Регистрирует объявление массива 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
Значение или значения массива для регистрации.
Исключения
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
Значение или значения массива для регистрации.
Исключения
arrayName
имеет значение null
.
Комментарии
Метод используется RegisterArrayDeclaration для регистрации массива клиентских скриптов, совместимого с частичной отрисовкой страниц и не зависимостей библиотеки Microsoft Ajax. Этот метод регистрирует массив при каждом возникновении асинхронной обратной передачи. Чтобы зарегистрировать массив для элемента управления, который находится внутри UpdatePanel элемента управления, чтобы массив регистрировался только при обновлении панели, используйте перегрузку RegisterArrayDeclaration(Control, String, String) этого метода.
Если вы хотите зарегистрировать массив, который не относится к частичным обновлениям страниц, и если вы хотите зарегистрировать массив только один раз во время первоначальной ClientScriptManager отрисовки страниц, используйте RegisterArrayDeclaration метод класса. Ссылку на ClientScriptManager объект можно получить из ClientScript свойства страницы.