ScriptManager::RegisterOnSubmitStatement Method (Page^, Type^, String^, String^)
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.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
public: static void RegisterOnSubmitStatement( Page^ page, Type^ type, String^ key, String^ script )
Parameters
- page
-
Type:
System.Web.UI::Page^
The page object that is registering the onsubmit statement.
- type
-
Type:
System::Type^
The type of the client script statement. 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
-
Type:
System::String^
A unique identifier for the script statement.
- script
-
Type:
System::String^
The script to register.
| Exception | Condition |
|---|---|
| ArgumentNullException | page is null. - or - type is null. |
Registering JavaScript code with this method causes the script to be included every time that an asynchronous postback occurs.
Note |
|---|
Code from any earlier asynchronous postbacks is not removed. New asynchronous postbacks append code to any existing code for the onsubmit statement. |
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.
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. You can get a reference to the ClientScriptManager object from the ClientScript property of the page.
Available since 3.5
