HtmlTableCell.ColSpan-Eigenschaft
Ruft die Anzahl der Spalten ab, die eine Zelle belegt, 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 ColSpan As Integer
'Usage
Dim instance As HtmlTableCell
Dim value As Integer
value = instance.ColSpan
instance.ColSpan = value
public int ColSpan { get; set; }
public:
property int ColSpan {
int get ();
void set (int value);
}
/** @property */
public int get_ColSpan ()
/** @property */
public void set_ColSpan (int value)
public function get ColSpan () : int
public function set ColSpan (value : int)
Eigenschaftenwert
Die Anzahl der Spalten, die die Zelle belegt, die durch eine Instanz von HtmlTableCell dargestellt wird. Der Standardwert ist -1 und gibt an, dass diese Eigenschaft nicht festgelegt ist.
Hinweise
Verwenden Sie in einer durch eine Instanz der HtmlTableCell-Klasse dargestellten Zelle die ColSpan-Eigenschaft, um die Anzahl der von der Zelle belegten Spalten anzugeben. Dadurch können Sie in der Tabelle eine Zelle erstellen, die mehr als eine Zeile belegt. Angenommen, eine Tabelle verfügt über zwei Spalten und zwei Zeilen. Sie können für die Tabelle eine Überschriftenzelle erstellen, die sich über beide Spalten erstreckt. Legen Sie die ColSpan-Eigenschaft der linken Zelle in der ersten Zeile auf den Wert 2 fest, um anzugeben, dass diese Zelle zwei Spalten der Tabelle belegt.
Warnung
Wenn Sie festlegen, dass eine Zelle mehrere Spalten belegen soll, müssen Sie darauf achten, dass Sie für jede in der Zeile belegte Spalte eine Zelle weniger definieren. Wenn z. B. eine Zelle zwei Spalten belegen soll, definieren Sie in der aktuellen Zeile eine Zelle weniger. Andernfalls ist die Zeile länger als die Anzahl der Spalten in der Tabelle, und die Tabelle wird nicht wie erwartet angezeigt.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der ColSpan-Eigenschaft angegeben wird, dass sich die Zelle in der ersten Zeile des HtmlTable-Steuerelements über zwei Spalten erstreckt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<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 colspan="2">
Cell 1.
</td>
</tr>
<tr>
<td>
Cell 3.
</td>
<td>
Cell 4.
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<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 colspan="2">
Cell 1.
</td>
</tr>
<tr>
<td>
Cell 3.
</td>
<td>
Cell 4.
</td>
</tr>
</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
HtmlTableCell-Klasse
HtmlTableCell-Member
System.Web.UI.HtmlControls-Namespace
HtmlTableCell.Align-Eigenschaft
NoWrap
RowSpan
VAlign