ClientScriptItem Class
Collapse the table of content
Expand the table of content

ClientScriptItem Class

Represents a client script element in a Web Form or user control at design time. This class cannot be inherited.


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

public sealed class ClientScriptItem

The ClientScriptItem type exposes the following members.

Public methodClientScriptItemInitializes a new instance of the ClientScriptItem class using the provided parameters.

Public propertyIdGets the ID attribute value for the client script element.
Public propertyLanguageGets the language attribute value for the client script element.
Public propertySourceGets the src attribute value for the client script element.
Public propertyTextGets the script statements contained in the client script element.
Public propertyTypeGets the type attribute value for the client script element.

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 methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

The ClientScriptItem class represents a script element that is contained in a Web document at design time. A custom control designer implementation can use a ClientScriptItem object to add client script elements to a Web Form or user control.

At design time, use the WebFormsRootDesigner class to set or examine client script elements that are contained in a document, such as a Web form, a Web server control, a content page, or a master page, on the design surface. Retrieve the collection of client script elements that are contained within the Web document by using the GetClientScriptsInDocument method. Add a client script element to the Web document by using the AddClientScriptToDocument method.

Typically, a script element either contains script statements or specifies an external location for script statements. The script element can optionally define the language of the script statements. Use the ClientScriptItem constructor to initialize the properties for a new script object. Use the ClientScriptItem properties to examine the script object attributes and contents. The Language property represents the language attribute of the script element. The Source property represents the src attribute. The Text property represents the script statements to be executed on the client that are contained in the script element.

Use the ClientScriptItem class to manage scripts that are to be executed at design-time.

To manage client script elements at run time, use the ClientScriptManager class. For more information about using client scripts at run time, see Client Script in ASP.NET Web Pages.


The ClientScriptItem class represents script elements at design time that are ultimately parsed and run in the client browser. Because the script elements that are generated for the ClientScriptItem objects are not run on the server, the elements do not contain the runat="server" attribute.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.

Community Additions

© 2016 Microsoft