Section D.1. ScriptManager

D.1. 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.

D.1.1. 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

D.1.2. 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

D.1.3. Scripts

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

Property	Description
Browser	Name of browser to which to load the script (e.g., with the value "Firefox", only Firefox browsers receive the script)
Path	Path and filename of the script to load
ScriptName	Name of the special Atlas script to load (supported values: AtlasUIDragDrop, AtlasUIGlitz, AtlasUIMap)

D.1.4. Services

The <Services> subelement of the ScriptManager control is used to enable web services support by generating a client-side proxy for them. In the <atlas:ServiceReference> control within the <Services> element, the following properties are supported:

Property	Description
GenerateProxy	Whether to automatically generate a proxy (defaults to true)
Path	Path and filename of the .asmx web service
Type	Type name with which to access the web service