ScriptManager::RegisterStartupScript Method (Page^, Type^, String^, String^, Boolean)

 

Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

Namespace:   System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public:
static void RegisterStartupScript(
	Page^ page,
	Type^ type,
	String^ key,
	String^ script,
	bool addScriptTags
)

Parameters

page
Type: System.Web.UI::Page^

The page object that is registering the client script block.

type
Type: System::Type^

The type of the client script block. 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 block.

script
Type: System::String^

The script to register.

addScriptTags
Type: System::Boolean

true to enclose the script block with <script> and </script> tags; otherwise, false.

You use this method to register a startup script block that is included every time that an asynchronous postback occurs. To register a script block for a control that is inside an UpdatePanel control so that the script block is registered only when the UpdatePanel control is updated, use the RegisterStartupScript(Control^, Type^, String^, String^, Boolean) overload of this method.

If you want to register a startup script that does not pertain to partial-page updates, and if you want to register the script only one time during initial page rendering, use the RegisterStartupScript method of the ClientScriptManager class. You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

.NET Framework
Available since 3.5
Return to top
Show: