HtmlTableCell.ColSpan Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Anzahl der Spalten ab, die von einer Zelle belegt werden, die durch eine Instanz der Klasse dargestellt wird, oder legt diese HtmlTableCell fest.
public:
property int ColSpan { int get(); void set(int value); };
public int ColSpan { get; set; }
member this.ColSpan : int with get, set
Public Property ColSpan As Integer
Eigenschaftswert
Die Anzahl der Spalten, die von der Zelle belegt werden, die durch eine Instanz von HtmlTableCell. Der Standardwert ist -1, der angibt, dass diese Eigenschaft nicht festgelegt ist.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die ColSpan Eigenschaft verwendet wird, um anzugeben, dass die Zelle in der ersten Zeile des HtmlTable Steuerelements zwei Spalten einnimmt.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableCell Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1" runat="server"
style="border-width: 1; border-color: Black">
<tr>
<td colspan="2">
Cell 1.
</td>
</tr>
<tr>
<td>
Cell 3.
</td>
<td>
Cell 4.
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableCell Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTableCell Example</h3>
<table id="Table1" runat="server"
style="border-width: 1; border-color: Black">
<tr>
<td colspan="2">
Cell 1.
</td>
</tr>
<tr>
<td>
Cell 3.
</td>
<td>
Cell 4.
</td>
</tr>
</table>
</form>
</body>
</html>
Hinweise
Verwenden Sie in einer Zelle, die durch eine Instanz der HtmlTableCell Klasse dargestellt wird, die ColSpan Eigenschaft, um die Anzahl der Spalten anzugeben, die die Zelle belegt. Auf diese Weise können Sie eine Zelle in der Tabelle erstellen, die mehr als eine Spalte belegt. Angenommen, Sie haben eine Tabelle, die zwei Spalten und zwei Zeilen enthält. Sie können eine Tabellenüberschriftzelle erstellen, die sich über beide Spalten erstreckt. Legen Sie die ColSpan Eigenschaft der zelle ganz links in der ersten Zeile fest, um 2 anzugeben, dass diese Zelle zwei Spalten in der Tabelle einnimmt.
Vorsicht
Achten Sie beim Überspannen von Spalten darauf, für jede Spalte, die Sie umfassen, eine weniger Zelle in der Zeile zu definieren. Wenn Sie beispielsweise zwei Spalten umfassen, definieren Sie eine weniger Zelle in der aktuellen Zeile. Andernfalls ist diese Zeile länger als die Anzahl der Spalten in der Tabelle, und die Tabelle wird nicht wie erwartet angezeigt.