Freigeben über

HtmlTableCell.ColSpan Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Ruft die Anzahl der Spalten ab, die eine Zelle belegt, die durch eine Instanz der HtmlTableCell-Klasse dargestellt wird, oder legt diese 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

Int32

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.

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 mit zwei Spalten und zwei Zeilen. Sie können eine Tabellenüberschriftzelle erstellen, die beide Spalten umfasst. Legen Sie die ColSpan Eigenschaft der linken Zelle in der ersten Zeile fest, um 2 anzugeben, dass diese Zelle zwei Spalten in der Tabelle einnimmt.

Achtung

Achten Sie beim Überschneiden von Spalten darauf, eine weniger Zelle in der Zeile für jede Spalte zu definieren, die Sie umfassen. Wenn Sie beispielsweise zwei Spalten umfassen, definieren Sie eine weniger Zelle in der aktuellen Zeile. Andernfalls wird diese Zeile länger als die Anzahl der Spalten in der Tabelle sein, und die Tabelle wird nicht wie erwartet angezeigt.

Gilt für

Siehe auch