WebControl.BackColor-Eigenschaft

Artikel
08/20/2007

Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property BackColor As Color
'Usage
Dim instance As WebControl
Dim value As Color

value = instance.BackColor

instance.BackColor = value

public virtual Color BackColor { get; set; }

public:
virtual property Color BackColor {
    Color get ();
    void set (Color value);
}

/** @property */
public Color get_BackColor ()

/** @property */
public void set_BackColor (Color value)

public function get BackColor () : Color

public function set BackColor (value : Color)

Eigenschaftenwert

Eine Color, die die Hintergrundfarbe des Steuerelements darstellt. Der Standardwert ist Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Hinweise

Mit der BackColor-Eigenschaft geben Sie die Hintergrundfarbe des Webserversteuerelements an. Diese Eigenschaft wird mit einem System.Drawing.Color-Objekt festgelegt.

Hinweis

Diese Eigenschaft wird nur bei bestimmten Steuerelementen dargestellt. Diese Eigenschaft wird z. B. von Table, Panel, DataGrid, Calendar und ValidationSummary dargestellt. Sie kann auch bei CheckBoxList, RadioButtonList und DataList verwendet werden, wenn deren RepeatLayout-Eigenschaft den Wert RepeatLayout.Table und nicht RepeatLayout.Flow hat.

Im Allgemeinen können in HTML 3.2 nur Steuerelemente eine Hintergrundfarbe anzeigen, die als <table>-Tag dargestellt werden, während das in HTML 4.0 bei fast allen Steuerelementen möglich ist.

In Microsoft Internet Explorer, Version 5 oder höher, wird diese Eigenschaft von Steuerelementen unterstützt, die als <span>-Tag dargestellt werden. Dazu zählen Label, alle Validierungssteuerelemente und alle Listensteuerelemente, deren RepeatLayout-Eigenschaft auf RepeatLayout.Flow festgelegt ist. Dies gilt jedoch nicht für Microsoft Internet Explorer, Version 4.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die BackColor-Eigenschaft des von der WebControl-Basisklasse geerbten Table-Steuerelements festgelegt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BackColor Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
 
    BackColor="LightGreen"
 >
 
    <asp:TableRow>
       <asp:TableCell>
          Row 0, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 0, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
    <asp:TableRow>
       <asp:TableCell>
          Row 1, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 1, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
 </asp:Table>
 
 </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BackColor Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
 
    BackColor="LightGreen"
 >
 
    <asp:TableRow>
       <asp:TableCell>
          Row 0, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 0, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
    <asp:TableRow>
       <asp:TableCell>
          Row 1, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 1, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
 </asp:Table>
 
 </form>
 
 </body>
 </html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 <body>
     <h3>BackColor Property of a Web Control</h3>
 
 <form runat=server>
 
 <asp:Table id="Table1" runat="server"
    CellPadding=10 
    GridLines="Both"
    BackColor="LightGreen"
 >
 
    <asp:TableRow>
       <asp:TableCell>
          Row 0, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 0, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
    <asp:TableRow>
       <asp:TableCell>
          Row 1, Col 0
       </asp:TableCell>
 
       <asp:TableCell>
          Row 1, Col 1
       </asp:TableCell>
    </asp:TableRow>
 
 </asp:Table>
 
 </form>
 
 </body>
 </html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace
Color
Style-Klasse
Table-Klasse
Panel-Klasse
DataGrid-Klasse
Calendar-Klasse
ValidationSummary-Klasse
CheckBoxList-Klasse
RadioButtonList-Klasse
DataList-Klasse
RepeatLayout-Enumeration

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Freigeben über