Programming Atlas

Appendix D. ScriptManager and UpdatePanel Declarative Reference

In this Appendix, the properties of two of the most important server controls of Atlas are covered: ScriptManager and UpdatePanel. All properties available when using the controls declaratively are described, with the exception of ID and runat="server".

ScriptManager

The ScriptManager is the most important control on an Atlas-powered web site since it is responsible for loading the client libraries and can also generate web services proxies.

Properties

Property	Description
EnablePartialRendering	Enables (true) or disables (false, default) the partial rendering implemented by UpdatePanel
EnableScriptComponents	Loads (true, default) or does not load (false) the client-script code used for communicating with Atlas server components
OnPageError	Registers an event handler when an error occurs on the page

ErrorTemplate

The <ErrorTemplate> subelement of the ScriptManager control holds an error message that is shown when an Ajax call returns an exception from the server. You are free to layout this template, however I recommend you specify two IDs: errorMessageLabel and okButton.

ID	Description
errorMessageLabel	ID of the <div> or <span> element to hold the error message
okButton	ID of the button that hides the error message when clicked upon

Scripts

The <Scripts> subelement of the ScriptManager control contains all client-side scripts that will be loaded, using the <atlas:ScriptReference> control. ...