ScriptManager.RegisterOnSubmitStatement ScriptManager.RegisterOnSubmitStatement ScriptManager.RegisterOnSubmitStatement Method

Определение

Регистрирует код ECMAScript (JavaScript), выполняемый при отправке формы.Registers ECMAScript (JavaScript) code that is executed when the form is submitted.

Перегрузки

RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String)

Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String)

Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String)

Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

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

Параметры

control
Control Control Control

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

type
Type Type Type

Тип оператора клиентского скрипта.The type of the client script statement. Этот параметр обычно задается с оператором typeof (C#) или GetType (Visual Basic) для извлечения типа элемента управления, регистрирующего скрипт.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

key
String String String

Уникальный идентификатор оператора скрипта.A unique identifier for the script statement.

script
String String String

Скрипт для регистрации.The script to register.

Исключения

controlnull.control is null.

- или --or- Свойство type имеет значение null.type is null.

Элемент управления control не найден в дереве элементов управления страницы.control is not in the page's control tree.

Комментарии

RegisterOnSubmitStatement Добавляет скрипт, выполняемый до отправки формы, что позволяет изменить отправку или отменить ее.The RegisterOnSubmitStatement adds script that is executed before the form is submitted, which lets you modify the submission or cancel it.

RegisterOnSubmitStatement Метод используется для onsubmit отображения инструкции, совместимой с частичной отрисовкой страниц, которая не имеет зависимостей библиотеки Microsoft AJAX.You use the RegisterOnSubmitStatement method to render an onsubmit statement that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Код JavaScript, зарегистрированный с помощью этого метода, отправляется на страницу только в том случае, если элемент управления, регистрирующий инструкцию, находится внутри UpdatePanel обновляемого элемента управления.JavaScript code that is registered by using this method is sent to the page only when the control that is registering the statement is inside an UpdatePanel control that is being updated. Чтобы зарегистрировать код при каждой асинхронной обратной передаче RegisterOnSubmitStatement(Page, Type, String, String) , используйте перегрузку этого метода.To register code with every asynchronous postback, use the RegisterOnSubmitStatement(Page, Type, String, String) overload of this method.

Если вы хотите зарегистрировать код JavaScript, который не относится к частичным обновлениям страницы, и если вы хотите зарегистрировать код только один раз во время первоначальной отрисовки страницы, используйте RegisterOnSubmitStatement метод ClientScriptManager класса.If you want to register JavaScript code that does not pertain to partial-page updates, and if you want to register the code only one time during initial page rendering, use the RegisterOnSubmitStatement method of the ClientScriptManager class. Ссылку на ClientScriptManager объект можно получить ClientScript из свойства страницы.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

** ПараметрRegisterOnSubmitStatement скрипта метода может содержать несколько команд сценария, разделенных точкой с запятой (;).The script parameter of the RegisterOnSubmitStatement method can contain multiple script commands that are delimited by using semicolons (;).

Дополнительные сведения о формах HTML и onsubmit событии см. на веб-сайте консорциум W3C (W3C).For more information about HTML forms and the onsubmit event, see the World Wide Web Consortium (W3C) Web site.

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

RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String)

Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

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

Параметры

page
Page Page Page

Объект страницы, регистрирующий оператор onsubmit.The page object that is registering the onsubmit statement.

type
Type Type Type

Тип оператора клиентского скрипта.The type of the client script statement. Этот параметр обычно задается с оператором typeof (C#) или GetType (Visual Basic) для извлечения типа элемента управления, регистрирующего скрипт.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

key
String String String

Уникальный идентификатор оператора скрипта.A unique identifier for the script statement.

script
String String String

Скрипт для регистрации.The script to register.

Исключения

Свойство page имеет значение null.page is null.

- или --or- typenull.type is null.

Комментарии

Регистрация кода JavaScript с помощью этого метода приводит к тому, что скрипт будет включаться при каждом выполнении асинхронной обратной передачи.Registering JavaScript code with this method causes the script to be included every time that an asynchronous postback occurs.

Примечание

Код из любых предыдущих асинхронных обратных передач не удаляется.Code from any earlier asynchronous postbacks is not removed. Новые асинхронные обратные передачи добавляют код в любой существующий код onsubmit для инструкции.New asynchronous postbacks append code to any existing code for the onsubmit statement.

Чтобы зарегистрировать код для элемента управления, находящегося UpdatePanel внутри элемента управления, чтобы код регистрировался только UpdatePanel при обновлении элемента управления, используйте RegisterOnSubmitStatement(Control, Type, String, String) перегрузку этого метода.To register code for a control that is inside an UpdatePanel control so that the code is registered only when the UpdatePanel control is updated, use the RegisterOnSubmitStatement(Control, Type, String, String) overload of this method.

Если вы хотите зарегистрировать код JavaScript, который не относится к частичным обновлениям страницы, и если вы хотите зарегистрировать код только один раз во время первоначальной отрисовки страницы, используйте RegisterOnSubmitStatement метод ClientScriptManager класса.If you want to register JavaScript code that does not pertain to partial-page updates, and if you want to register the code only one time during initial page rendering, use the RegisterOnSubmitStatement method of the ClientScriptManager class. Ссылку на ClientScriptManager объект можно получить ClientScript из свойства страницы.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

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

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