Freigeben über


HtmlTableCell-Konstruktor (String)

Initialisiert eine neue Instanz der HtmlTableCell-Klasse mit dem angegebenen Tagnamen.

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

Syntax

'Declaration
Public Sub New ( _
    tagName As String _
)
'Usage
Dim tagName As String

Dim instance As New HtmlTableCell(tagName)
public HtmlTableCell (
    string tagName
)
public:
HtmlTableCell (
    String^ tagName
)
public HtmlTableCell (
    String tagName
)
public function HtmlTableCell (
    tagName : String
)

Parameter

  • tagName
    Der Elementname des Tags.

Hinweise

Mit diesem Konstruktor können Sie eine neue Instanz der HtmlTableCell-Klasse erstellen und initialisieren. Sie können hiermit ein HtmlTableCell-Objekt erstellen, das eine Zelle in einem HtmlTable-Steuerelement darstellt. Normalerweise wird der Konstruktor zum Erstellen eines HtmlTableCell-Objekts verwendet, das ein <th>-Element für eine Tabellenüberschriftenzelle darstellt. Obwohl Sie mit diesem Konstruktor ein <td>-Element für eine Datenzelle einer Tabelle erstellen können, wird hierfür normalerweise der Standardkonstruktor verwendet.

Hinweis

Obwohl Sie mit diesem Konstruktor das zu erstellende Zellenelement angeben können, wird das <th>-Element als einziges Zellenelement unterstützt. Für die Kompatibilität mit zukünftigen Versionen können Sie mit diesem Konstruktor andere HTML-Zellenelemente erstellen, die möglicherweise verfügbar werden.

In der folgenden Tabelle ist der anfängliche Eigenschaftenwert für eine Instanz von HtmlTableCell aufgeführt.

Eigenschaft

Anfangswert

TagName

Der Wert des tagName-Parameters.

Beispiel

Im folgenden Codebeispiel wird das Erstellen einer Instanz eines HtmlTable-Steuerelements mit HtmlTableCell-Steuerelementen und das Platzieren auf der Webseite veranschaulicht. Beachten Sie, wie der Standardkonstruktor des HtmlTableCell-Steuerelements zum Erstellen eines <td>-Elements verwendet wird, während der überladene Konstruktor, der einen Zeichenfolgenparameter akzeptiert, mit dem Literal "th" zum Erstellen eines <th>-Elements verwendet wird.

<%@ Page Language="VB" AutoEventWireup="True" %>

<script runat="server" >
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    ' Create an instance of an HtmlTable control.
    Dim table As HtmlTable = New HtmlTable()
    table.Border = 1
    table.CellPadding = 3

    ' Populate the HtmlTable control by adding rows to it.
    Dim rowcount As Integer
    Dim cellcount As Integer
          
    ' Create the rows of the table.
    For rowcount = 0 To 4

      ' Create a new HtmlTableRow control.
      Dim row As HtmlTableRow = New HtmlTableRow()
            
      ' Add cells to the HtmlTableRow control. 
      For cellcount = 0 To 3
          
        ' Define a new HtmlTableCell control.
        Dim cell As HtmlTableCell

        ' Create table header cells for the first row.
        If rowcount <= 0 Then
             
          cell = New HtmlTableCell("th")
           
        Else
               
          cell = New HtmlTableCell()
               
        End If

        ' Create the text for the cell.
        cell.Controls.Add(New LiteralControl( _
          "row " & rowcount.ToString() & ", " & _
          "column " & cellcount.ToString()))

        ' Add the cell to the HtmlTableRow Cells collection.
        row.Cells.Add(cell)
               
      Next cellcount

      ' Add the row to the HtmlTable Rows collection.
      table.Rows.Add(row)
          
    Next rowcount
 
    ' Add the control to the Controls collection of the 
    ' PlaceHolder control.
    Place.Controls.Clear()
    Place.Controls.Add(table)
         
  End Sub
  
</script>

<html>
<head>
   <title>HtmlTable Example</title>
</head>  
<body>

   <form runat="server">
  
      <h3> HtmlTable Example </h3> 
  
      <asp:PlaceHolder id="Place" 
                       runat="server"/>
  
   </form>

</body>
</html>
 
<%@ Page Language="C#" AutoEventWireup="True" %>

<script runat="server" >
  
  void Page_Load(Object sender, EventArgs e)
  {

    // Create an instance of an HtmlTable control.
    HtmlTable table = new HtmlTable();
    table.Border = 1;
    table.CellPadding = 3;

    // Populate the HtmlTable control by adding rows to it. 
    for (int rowcount = 0; rowcount < 5; rowcount++)
    {
      // Create a new HtmlTableRow control.
      HtmlTableRow row = new HtmlTableRow();

      // Add cells to the HtmlTableRow control.
      for (int cellcount = 0; cellcount < 4; cellcount++)
      {
        // Define a new HtmlTableCell control.
        HtmlTableCell cell;

        // Create table header cells for the first row.
        if (rowcount <= 0)
        {
          cell = new HtmlTableCell("th");
        }
        else
        {
          cell = new HtmlTableCell();
        }

        // Create the text for the cell.
        cell.Controls.Add(new LiteralControl(
          "row " + rowcount.ToString() + ", " +
          "column " + cellcount.ToString()));

        // Add the cell to the HtmlTableRow Cells collection. 
        row.Cells.Add(cell);

      }

      // Add the row to the HtmlTable Rows collection.
      table.Rows.Add(row);

    }

    // Add the control to the Controls collection of the 
    // PlaceHolder control.
    Place.Controls.Clear();
    Place.Controls.Add(table);

  }
  
</script>

<html>
<head>
   <title>HtmlTable Example</title>
</head>
<body>

   <form runat="server">
  
      <h3> HtmlTable Example </h3> 
  
      <asp:PlaceHolder id="Place" 
                       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
HtmlControl.TagName-Eigenschaft

Weitere Ressourcen

HTML-Serversteuerelemente