ASPxSchedulerStorageControl.ClientInstanceName Property
Gets or sets the ASPSchedulerStorageControl’s client programmatic identifier.
Namespace: DevExpress.Web.ASPxScheduler
Assembly: DevExpress.Web.ASPxScheduler.v24.1.dll
NuGet Package: DevExpress.Web.Scheduler
Declaration
Property Value
Type | Default | Description |
---|---|---|
String | String.Empty | A string value that specifies the ASPSchedulerStorageControl’s client identifier. |
Remarks
Use the ClientInstanceName property to specify a unique client-side identifier for a scheduler storage control. The ClientInstanceName property’s value can be used on the client side to programmatically access the client object rendered for the scheduler storage control in client-side script. This property is particularly important in referencing the scheduler storage control when it is contained within a naming container (for instance, within an ASPxPageControl‘s page).
If the ClientInstanceName property is not specified, a scheduler storage 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 by its ID is not allowed when it is contained within a naming container.
Special Characters in Client Instance Name
If the ClientInstanceName
property contains special characters, for instance, the dot (.
), you cannot access a client object by this name. Call the GetByName(name) method to retrieve the client-side object instead.
<dx:ASPxTextBox ... ClientInstanceName="SomeType.SomeProp" />
var txt = ASPxClientControl.GetControlCollection().GetByName("SomeType.SomeProp");
txt.SetText("Some Text");