System.Web.UI.WebControls Namespace   WebControl Class

---

Sets or retrieves the background color of a Web control.

Inline	<asp:control BackColor = strColor ... >
Script	WebControl.BackColor [ = strColor ]

strColor

A System.Drawing.Color that represents the background color of the control, using any of the standard .NET color identifiers. See Color Table.

This property is read/write and returns an empty string if not set.

BackColor is used to specify the color under the content ( the background color ) of a Web server control. This property is set using a System.Drawing.Color object, the possible range of values of which are specified in this workshop's Color Table.

Note that this property will render only for certain controls.

In general, only controls that render as an HTML <table> or <div> element ( block objects ) can display a background color, such as Table, Panel, DataGrid, Calendar, etc.

It will also work for list controls that have their RepeatLayout property set to Table, such as the CheckBoxList, RadioButtonList and DataList.

For controls that render as an HTML <span> tag ( including Label, all validation controls, and list controls with their RepeatLayout property set to Flow ), this property will work only in Internet Explorer 5 and later.

The following example shows how to declaratively set the BackColor property of a Web control at design time.

<asp:button id = "myButton" runat = "server" text = "Reload"
   backcolor = "maroon" forecolor = "gold" font-bold />

The example below shows how to programmatically set the BackColor property at run time, depending on user input. The code also demonstrates how simple it is to retrieve the available colors in .NET ( via the KnownColor enum ), and dynamically add each to a selectable list.

void Page_Load ( Object src, EventArgs e ) {
   if ( !IsPostBack ) {
      Array colors = Enum.GetValues ( typeof ( KnownColor ) );
      foreach ( KnownColor k in colors ) {
         Color c = Color.FromKnownColor ( k );
         if ( !c.IsSystemColor )
            colorSelect.Items.Add ( c.Name );
      }
   }
   myTable.BackColor = Color.FromName ( colorSelect.SelectedItem.Text );
}

 Show me 

The following example allows a user to dynamically preview various ForeColor and BackColor combinations.

 Show me 

WebControl Members   Style   Base Web Control Properties

Suggested Reading