EditPropertiesBase.ClientInstanceName Property

Specifies the editor’s client programmatic identifier.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

[DefaultValue("")]
public string ClientInstanceName { get; set; }

VB.NET

<DefaultValue("")>
Public Property ClientInstanceName As String

Property Value

Type	Default	Description
String	String.Empty	A string value that specifies the editor’s client identifier.

Remarks

Use the ClientInstanceName property to specify a unique client-side identifier for an editor control. The ClientInstanceName property’s value can be used on the client side to programmatically access the client object rendered for the editor in client-side script. This property is particularly important in referencing the editor when it is contained within a naming container (for instance, within an ASPxPageControl‘s page or an ASPxPopupControl‘s window).

If the ClientInstanceName property is not specified, an editor’s client identifier is generated automatically and equals the value of the editor’s ClientID property.

Note that for the ASPxImage control, it’s not recommended to define the same identifier for the ID and ClientInstanceName properties. Doing this might lead to a JavaScript error generated when accessing the control on the client, using the ClientInstanceName property’s value. As a workaround, you can add a “window.” prefix when accessing the control:

window.ASPxImage1.SetSize(32, 32);

But, it’s better to use different names for the ASPxImage‘s ID and ClientInstanceName properties, and the ClientInstanceName property’s value shouldn’t coincide with any HTML element identifier on that specific page.

Note that the client-side programmatic interface is available if the EditPropertiesBase.EnableClientSideAPI property is set to true.

Note

If the ClientInstanceName property contains special characters, use the approach described in the following Knowledge Base Article to access the client-side programmatic object.

KA18687: How to use the ClientInstanceName and Name properties when they contain special characters

Note

The ClientInstanceName property synchronizes its value with the editor’s ASPxEditBase.ClientInstanceName property.

Example

For ASPxMemo:

ASPX

<script type="text/javascript" >
function OnClick(s, e) {
    alert(memo.GetText());
}
</script>

<dx:ASPxMemo ID="Memo" runat="server" Height="70px" ClientInstanceName="memo" Width="170px">
</dx:ASPxMemo>
<dx:ASPxButton ID="Button" runat="server" Text="Get Memo Text" AutoPostBack="false">
     <ClientSideEvents Click="OnClick" />
</dx:ASPxButton>