ASPxMenuBase.ClientInstanceName Property

Gets or sets the ASPxMenuBase‘s client programmatic identifier.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

NuGet Package: DevExpress.Web

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 ASPxMenuBase‘s client identifier.

Remarks

Use the ClientInstanceName property to specify a unique client-side identifier for the ASPxMenuBase control. The ClientInstanceName property’s value can be used on the client side to programmatically access the client object rendered for the ASPxMenuBase control in client-side script. This property is particularly important in referencing the ASPxMenuBase control 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 for a control, the control’s client identifier is generated automatically and equals the value of the control’s ID property. Note that in this case, client-side programmatic access to the control is not allowed when the control is contained within a naming container.

Note

The client-side programmatic interface is available if the ASPxMenuBase.EnableClientSideAPI property is set to true.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ClientInstanceName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-change-an-appointments-custom-field-values-via-the-appointment-context-menu-like-fo-t164645/CS/WebApplication1/Default.aspx.cs#L80

if(e.Menu.MenuId == DevExpress.XtraScheduler.SchedulerMenuItemId.AppointmentMenu) {
    e.Menu.ClientInstanceName = "AppointmentPopupMenu";
    e.Menu.ClientSideEvents.PopUp = "OnClientPopupMenuShowing";

how-to-implement-the-copy-paste-appointment-operation-via-the-context-menu-t164287/CS/WebApplication1/Default.aspx.cs#L74

protected void ASPxScheduler1_PopupMenuShowing(object sender, DevExpress.Web.ASPxScheduler.PopupMenuShowingEventArgs e) {
    e.Menu.ClientInstanceName = "AppointmentPopupMenu";
    e.Menu.ClientSideEvents.PopUp = "OnClientPopupMenuShowing";

VB.NET

how-to-change-an-appointments-custom-field-values-via-the-appointment-context-menu-like-fo-t164645/VB/WebApplication1/Default.aspx.vb#L82

If e.Menu.MenuId = DevExpress.XtraScheduler.SchedulerMenuItemId.AppointmentMenu Then
    e.Menu.ClientInstanceName = "AppointmentPopupMenu"
    e.Menu.ClientSideEvents.PopUp = "OnClientPopupMenuShowing"

how-to-implement-the-copy-paste-appointment-operation-via-the-context-menu-t164287/VB/WebApplication1/Default.aspx.vb#L77

Protected Sub ASPxScheduler1_PopupMenuShowing(ByVal sender As Object, ByVal e As DevExpress.Web.ASPxScheduler.PopupMenuShowingEventArgs)
    e.Menu.ClientInstanceName = "AppointmentPopupMenu"
    e.Menu.ClientSideEvents.PopUp = "OnClientPopupMenuShowing"