This documentation is archived and is not being maintained.

ClientScriptManager::RegisterExpandoAttribute Method (String, String, String, Boolean)

Registers a name/value pair as a custom (expando) attribute of the specified control given a control ID, an attribute name, an attribute value, and a Boolean value indicating whether to encode the attribute value.

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

public:
void RegisterExpandoAttribute(
	String^ controlId, 
	String^ attributeName, 
	String^ attributeValue, 
	bool encode
)

Parameters

controlId
Type: System::String
The Control on the page that contains the custom attribute.
attributeName
Type: System::String
The name of the custom attribute to register.
attributeValue
Type: System::String
The value of the custom attribute.
encode
Type: System::Boolean
A Boolean value indicating whether to encode the custom attribute to register.

The RegisterExpandoAttribute method registers a name/value pair as a custom (expando) attribute on the specified Control. The expando attribute is set dynamically from JavaScript to preserve XHTML compatibility for the rendered control's markup. Set the encode parameter to true if you need to escape quotes and backslashes in your expando attribute's value.

If the expando attribute is not found or the control to add the expando attribute to is not found, the client script is still emitted, but it will not affect the control.

The following code example demonstrates how to use the RegisterExpandoAttribute method of the ClientScriptManager class. The client script in the rendered page sets the title attribute of a <span> element.

No code example is currently available or this language may not be supported.

.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.
Show: