Registers a client script block with the ScriptManager control each time an asynchronous postback occurs, and then adds the script block to the page.
Syntax
CSharp
VisualBasic
Public Shared Sub RegisterClientScriptBlock ( _
page As Page, _
type As Type, _
key As String, _
script As String, _
addScriptTags As Boolean _
)
ManagedCPlusPlus
public:
static void RegisterClientScriptBlock (
Page^ page,
Type^ type,
String^ key,
String^ script,
bool addScriptTags
)
JSharp
Parameters
- page (Page)
The Page object that is registering the client script block.
- type (Type)
The type of the client script block. This parameter is usually specified by using the typeof (C# Reference) operator (C#) or the GetType Operator operator (Visual Basic) to retrieve the type of the control that is registering the script.
- key (String)
The string that uniquely identifies the script block.
- script (String)
A string that contains the script.
- addScriptTags (Boolean)
A Boolean value that indicates whether to enclose the script block in <script> tags.
Remarks
Registering a script block with this method causes the script to be rendered each time an asynchronous postback occurs. To register a script block for a control inside an UpdatePanel control so that script is registered only when the UpdatePanel control is updated, use the RegisterClientScriptBlock(Control, Type, String, String, Boolean) overload of this method.
If you are registering a script block that does not pertain to partial-page updates and if you want to register a script block once during initial page rendering, use the RegisterClientScriptBlock(Type, String, String) method of the ClientScriptManager class. You can get a reference to the ClientScriptManager object from the ClientScript property of the page.
Exceptions
| Exception | Condition |
|---|
| ArgumentNullException | The script block type is null. - or - The page that is registering the script block is null. |
Assembly: System.Web.Extensions (Module: System.Web.Extensions)