ASPxLabel Class

A label control.

Assembly: DevExpress.Web.v19.1.dll

Declaration

C#
VB.NET

public class ASPxLabel :
    ASPxStaticEdit,
    ITextControl

Public Class ASPxLabel
    Inherits ASPxStaticEdit
    Implements ITextControl

The following members return ASPxLabel objects:

Remarks

The ASPxLabel allows you to display text on a web page.

ASPxLabel - Label

Create a Label Control

Design Time

The ASPxLabel control is available on the DX.19.1: Common Controls toolbox tab in the Microsoft Visual Studio IDE.

Drag the control onto a form and customize control settings, or paste the control markup in the page’s source code.

ASPX

<dx:ASPxLabel runat="server" Text="Label Text">
</dx:ASPxLabel>

using DevExpress.Web;

protected void Page_Load(object sender, EventArgs e)
{
    ASPxLabel label = new ASPxLabel();
    label.ID = "ASPxLabel1";
    form1.Controls.Add(label);
    label.Text = "Label Text";
}

Imports DevExpress.Web

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim label As ASPxLabel = New ASPxLabel()
    label.ID = "ASPxLabel1"
    form1.Controls.Add(label)
    label.Text = "Label Text"
End Sub

Client-Side API

The ASPxLabel‘s client-side API is implemented with JavaScript language and exposed by the ASPxClientLabel object.

Availability	Available by default.
Class name	ASPxClientLabel
Access name	ClientInstanceName
Events	ASPxLabel.ClientSideEvents

ASPX

<dx:ASPxTextBox ID="ASPxTextBox1" runat="server" Width="170px" ClientInstanceName="textBox"></dx:ASPxTextBox>

<dx:ASPxButton ID="ASPxButton1" runat="server" Text="Set Label Text" AutoPostBack="False" >
  <ClientSideEvents Click="function(s, e) {   label.SetText(textBox.GetText()); }" />
</dx:ASPxButton>

<dx:ASPxLabel ID="ASPxLabel1" runat="server" Text="" ClientInstanceName="label">
</dx:ASPxLabel>

Features

Ability to Associate a Label to a Control

You can associate a control with the Label control (ASPxLabel.AssociatedControlID). On a web page, a browser renders the label as an HTML label element. The label’s “for” attribute is set to the associated control’s ID property.
- ASPX
```
<dx:ASPxLabel ID="ASPxLabel1" runat="server" AssociatedControlID="ASPxComboBox1" Text="ASPxLabel">
</dx:ASPxLabel>
<dx:ASPxComboBox ID="ASPxComboBox1" runat="server">
</dx:ASPxComboBox>
```

Appearance Customization

You can customize control appearance as follows: apply a DevExpress Theme, style settings, or assign CSS classes.

ASPX

<dx:ASPxLabel runat="server" Text="Label Text" BackColor="Red" ID="Label" ForeColor="White" />
<dx:ASPxCheckBox runat="server" Text="Successfull" OnCheckedChanged="OnCheckedChanged" AutoPostBack="true" />

protected void OnCheckedChanged(object s, EventArgs e) {
    Label.BackColor = (s as ASPxCheckBox).Checked ? System.Drawing.Color.Green : System.Drawing.Color.Red; 
}