HtmlTableCell.BgColor-Eigenschaft
Ruft die Hintergrundfarbe der Zelle ab, die durch eine Instanz der HtmlTableCell-Klasse dargestellt wird, oder legt diese fest.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Property BgColor As String
'Usage
Dim instance As HtmlTableCell
Dim value As String
value = instance.BgColor
instance.BgColor = value
public string BgColor { get; set; }
public:
property String^ BgColor {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_BgColor ()
/** @property */
public void set_BgColor (String value)
public function get BgColor () : String
public function set BgColor (value : String)
Eigenschaftenwert
Die Hintergrundfarbe der Zelle, die durch eine Instanz von HtmlTableCell dargestellt wird.
Hinweise
Geben Sie mit der BgColor-Eigenschaft die Hintergrundfarbe der Zelle an, die durch eine Instanz der HtmlTableCell-Klasse dargestellt wird. Sie können eine Farbe entweder mit dem Namen oder mit einem Hexadezimalwert mit vorangestelltem Nummernzeichen (#) in der Form #RRGGBB angeben. RR, GG und BB stellen Hexadezimalwerte von 0 bis 255 dar, die jeweils den Rot-, Grün- und Blauanteil einer Farbe angeben. Beispielweise stellt der Wert #0000FF die Farbe Blau dar. Für den Rot- und den Grünanteil wird der minimale Wert (00) angegeben, wohingegen für den Blauanteil der maximale Wert (FF) angegeben wird.
In der folgenden Tabelle werden die sechzehn vordefinierten HTML-Farbnamen und ihre entsprechenden Hexadezimalwerte aufgeführt, die für die BgColor-Eigenschaft verwendet werden können. Weitere Informationen über HTML-Farben finden Sie auf der Website des World Wide Web Consortium (W3C) (nur auf Englisch verfügbar).
Farbname |
Hexadezimaler Wert |
|---|---|
Aqua |
#00FFFF |
Black |
#000000 |
Blue |
#0000FF |
Fuchsia |
#FF00FF |
Gray |
#808080 |
Green |
#008000 |
Lime |
#00FF00 |
Maroon |
#800000 |
Navy |
#000080 |
Olive |
#808000 |
Purple |
#800080 |
Red |
#FF0000 |
Silver |
#C0C0C0 |
Teal |
#008080 |
White |
#FFFFFF |
Yellow |
#FFFF00 |
Die für die BgColor-Eigenschaft verfügbaren Farben können mithilfe der KnownColor-Enumeration bestimmt werden.
Bei Farbnamen wird die Groß- und Kleinschreibung nicht berücksichtigt.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der BgColor-Eigenschaft die Hintergrundfarbe der Zellen in einem HtmlTable-Steuerelement programmgesteuert festgelegt wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim i As Integer
Dim j As Integer
' Iterate through the rows of the table.
For i = 0 To Table1.Rows.Count - 1
' Iterate through the cells of a row.
For j = 0 To Table1.Rows(i).Cells.Count - 1
' Update the properties of each cell.
Table1.Rows(i).Cells(j).BgColor = BgColorSelect.Value
Table1.Rows(i).Cells(j).BorderColor = BorderColorSelect.Value
Table1.Rows(i).Cells(j).Height = HeightSelect.Value
Table1.Rows(i).Cells(j).Width = WidthSelect.Value
Next j
Next i
End Sub
</script>
<html>
<head>
<title>HtmlTableCell Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
border="1"
bordercolor="black"
runat="server">
<tr>
<td>
Cell 1.
</td>
<td>
Cell 2.
</td>
</tr>
<tr>
<td>
Cell 3.
</td>
<td>
Cell 4.
</td>
</tr>
</table>
<hr>
Select the display settings for the cells in the table: <br><br>
BgColor:
<select id="BgColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black">Black</option>
<option value="White" selected>White</option>
</select>
BorderColor:
<select id="BorderColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black" selected>Black</option>
<option value="White">White</option>
</select>
<br><br>
Height:
<select id="HeightSelect"
runat="server">
<option value="0">0</option>
<option value="100">100</option>
<option value="150">150</option>
<option value="200">200</option>
<option value="250">250</option>
</select>
Width:
<select id="WidthSelect"
runat="server">
<option value="0">0</option>
<option value="200">200</option>
<option value="250">250</option>
<option value="300">300</option>
<option value="350">350</option>
</select>
<br><br>
<input type="button"
value="Generate Table"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
// Iterate through the rows of the table.
for (int i = 0; i <= Table1.Rows.Count - 1; i++)
{
// Iterate through the cells of a row.
for (int j = 0; j <= Table1.Rows[i].Cells.Count - 1; j++)
{
// Update the properties of each cell.
Table1.Rows[i].Cells[j].BgColor = BgColorSelect.Value;
Table1.Rows[i].Cells[j].BorderColor = BorderColorSelect.Value;
Table1.Rows[i].Cells[j].Height = HeightSelect.Value;
Table1.Rows[i].Cells[j].Width = WidthSelect.Value;
}
}
}
</script>
<html>
<head>
<title>HtmlTableCell Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1"
border="1"
bordercolor="black"
runat="server">
<tr>
<td>
Cell 1.
</td>
<td>
Cell 2.
</td>
</tr>
<tr>
<td>
Cell 3.
</td>
<td>
Cell 4.
</td>
</tr>
</table>
<hr>
Select the display settings for the cells in the table: <br><br>
BgColor:
<select id="BgColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black">Black</option>
<option value="White" selected>White</option>
</select>
BorderColor:
<select id="BorderColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black" selected>Black</option>
<option value="White">White</option>
</select>
<br><br>
Height:
<select id="HeightSelect"
runat="server">
<option value="0">0</option>
<option value="100">100</option>
<option value="150">150</option>
<option value="200">200</option>
<option value="250">250</option>
</select>
Width:
<select id="WidthSelect"
runat="server">
<option value="0">0</option>
<option value="200">200</option>
<option value="250">250</option>
<option value="300">300</option>
<option value="350">350</option>
</select>
<br><br>
<input type="button"
value="Generate Table"
onserverclick="Button_Click"
runat="server"/>
</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
HtmlTableCell-Klasse
HtmlTableCell-Member
System.Web.UI.HtmlControls-Namespace
HtmlTable-Klasse
BorderColor
Height
Width
KnownColor