This documentation is archived and is not being maintained.

ScriptManager.LoadScriptsBeforeUI Property

Gets or sets a value that indicates whether scripts are loaded before or after markup for the page UI is loaded.

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

public bool LoadScriptsBeforeUI { get; set; }
<asp:ScriptManager LoadScriptsBeforeUI="True|False" />

Property Value

Type: System.Boolean
true if scripts are loaded before markup for the UI is loaded; false if scripts are loaded after markup for the UI is loaded. The default is true.

The LoadScriptsBeforeUI property determines how scripts in the Scripts collection are loaded relative to the markup for the page UI.

When the LoadScriptsBeforeUI property is true, a script element is rendered before the page's UI markup is loaded. In this scenario, if UI elements are defined in scripts, the UI will be fully functional when it loads. However, if the script accesses UI elements in the markup for which instances have not yet been created, an error might occur. To make sure that UI elements are loaded before you access them, handle the load event of the Sys.Application class.

When the LoadScriptsBeforeUI property is false, a script element is rendered after the page's UI markup is rendered. In this scenario, the UI loads more quickly, but it might not be fully functional if scripts that define additional UI elements have not finished loading.

.NET Framework

Supported in: 4, 3.5

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.