This documentation is archived and is not being maintained.

CompositeScriptReference Class

Represents a collection of script references to combine into a single composite script.


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

public class CompositeScriptReference : ScriptReferenceBase

The CompositeScriptReference type exposes the following members.

Public methodCompositeScriptReferenceInitializes a new instance of the CompositeScriptReference class.

Public propertyNotifyScriptLoaded Obsolete. Gets or sets a value that indicates whether the ScriptResourceHandler object automatically adds code at the end of the ECMAScript (JavaScript) file to call the client NotifyScriptLoaded method of the Sys.Application class. (Inherited from ScriptReferenceBase.)
Public propertyPathGets or sets the path of the referenced client script file, relative to the Web page. (Inherited from ScriptReferenceBase.)
Public propertyResourceUICulturesGets or sets a comma-delimited list of UI cultures that are supported by the Path property. (Inherited from ScriptReferenceBase.)
Public propertyScriptModeGets or sets the version of the client script file (release or debug) to use. (Inherited from ScriptReferenceBase.)
Public propertyScriptsGets a collection of script references that are contained in the composite script object.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodGetUrlInfrastructure. Returns the URL that is rendered as the value of the src attribute of the script element. (Overrides ScriptReferenceBase.GetUrl(ScriptManager, Boolean).)
Protected methodIsAjaxFrameworkScriptInfrastructure. Determines whether the composite script is a reference to an ASP.NET AJAX framework script. (Overrides ScriptReferenceBase.IsAjaxFrameworkScript(ScriptManager).)
Protected methodIsFromSystemWebExtensionsInfrastructure. Obsolete. Indicates whether the composite script contains a reference to an ASP.NET AJAX framework script. (Overrides ScriptReferenceBase.IsFromSystemWebExtensions().)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

The number of script references that a CompositeScriptReference instance can contain is limited by the size of the resulting URL. The URL cannot be longer than 1024 characters.

If you have to work around this limitation, you have two options. The first option is to reduce the number of ScriptReference objects that the composite script contains. The second option is to manually combine the scripts into a single static file. In that case, you can set the Path property to the location of the static file.

.NET Framework

Supported in: 4, 3.5 SP1

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.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.