Tab
A newer version of this page is available. Switch to the current version.

ASPxLabel Class

A label control.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.2.dll

Declaration

public class ASPxLabel :
    ASPxStaticEdit,
    ITextControl
Public Class ASPxLabel
    Inherits ASPxStaticEdit
    Implements ITextControl

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

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

Run Time

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";
}

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

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

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

    <script runat="server">
    protected void OnCheckedChanged(object s, EventArgs e) {
        Label.BackColor = (s as ASPxCheckBox).Checked ? System.Drawing.Color.Green : System.Drawing.Color.Red; 
    }
    </script>
    
    <dx:ASPxLabel runat="server" Text="Label Text" BackColor="Red" ID="Label" ForeColor="White" />
    <dx:ASPxCheckBox runat="server" Text="Successfull" OnCheckedChanged="