ScriptManager.RegisterOnSubmitStatement Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.Extensions.dll

Регистрирует код ECMAScript (JavaScript), выполняемый при отправке формы.

Перегрузки

Имя	Описание
RegisterOnSubmitStatement(Page, Type, String, String)	Регистрирует код ECMAScript (JavaScript) с элементом управления, который используется с ScriptManager элементом UpdatePanel управления, выполняемым при отправке формы.
RegisterOnSubmitStatement(Control, Type, String, String)	Регистрирует код ECMAScript (JavaScript) с элементом управления, который используется с ScriptManager элементом UpdatePanel управления, выполняемым при отправке формы.

RegisterOnSubmitStatement(Page, Type, String, String)

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

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script);

public static void RegisterOnSubmitStatement(System.Web.UI.Page page, Type type, string key, string script);

static member RegisterOnSubmitStatement : System.Web.UI.Page * Type * string * string -> unit

Public Shared Sub RegisterOnSubmitStatement (page As Page, type As Type, key As String, script As String)

Параметры

page

Page

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

type

Type

Тип инструкции клиентского скрипта. Обычно этот параметр указывается с помощью оператора typeof (C#) или оператора GetType (Visual Basic) для получения типа элемента управления, регистрирующего скрипт.

key

String

Уникальный идентификатор инструкции скрипта.

script

String

Скрипт для регистрации.

Исключения

ArgumentNullException

page равно null.

–или–

type равно null.

Комментарии

Регистрация кода JavaScript с помощью этого метода приводит к тому, что скрипт будет включаться при каждом выполнении асинхронной обратной передачи.

Замечание

Код из любых предыдущих асинхронных обратных вызовов не удаляется. Новые асинхронные обратные передачи добавляют код к любому существующему коду инструкции onsubmit .

Чтобы зарегистрировать код элемента управления, который находится внутри UpdatePanel элемента управления, чтобы код регистрировался только при UpdatePanel обновлении элемента управления, используйте RegisterOnSubmitStatement(Control, Type, String, String) перегрузку этого метода.

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

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

• RegisterOnSubmitStatement(Control, Type, String, String)

RegisterOnSubmitStatement(Control, Type, String, String)

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

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script);

public static void RegisterOnSubmitStatement(System.Web.UI.Control control, Type type, string key, string script);

static member RegisterOnSubmitStatement : System.Web.UI.Control * Type * string * string -> unit

Public Shared Sub RegisterOnSubmitStatement (control As Control, type As Type, key As String, script As String)

Параметры

control

Control

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

type

Type

Тип инструкции клиентского скрипта. Обычно этот параметр указывается с помощью оператора typeof (C#) или оператора GetType (Visual Basic) для получения типа элемента управления, регистрирующего скрипт.

key

String

Уникальный идентификатор инструкции скрипта.

script

String

Скрипт для регистрации.

Исключения

ArgumentNullException

control равно null.

–или–

type равно null.

ArgumentException

control не находится в дереве элементов управления страницы.

Комментарии

Добавляет RegisterOnSubmitStatement скрипт, который выполняется перед отправкой формы, что позволяет изменять отправку или отменять его.

Метод используется RegisterOnSubmitStatement для отрисовки инструкции, совместимой с частичной onsubmit отрисовкой страницы и не имеющих зависимостей библиотеки Microsoft Ajax. Код JavaScript, зарегистрированный с помощью этого метода, отправляется на страницу только в том случае, если элемент управления, регистрирующий инструкцию, находится внутри обновляемого UpdatePanel элемента управления. Чтобы зарегистрировать код с помощью каждой асинхронной обратной передачи, используйте перегрузку RegisterOnSubmitStatement(Page, Type, String, String) этого метода.

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

Параметр скриптаRegisterOnSubmitStatement метода может содержать несколько команд скриптов, разделенных точкой с запятой (;).

Дополнительные сведения о формах HTML и onsubmit событиях см. на веб-сайте консорциума W3C.

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

• RegisterOnSubmitStatement(Page, Type, String, String)