Freigeben über


TableCellCollection.Clear-Methode

Entfernt alle TableCell-Objekte aus TableCellCollection.

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

Syntax

'Declaration
Public Sub Clear
'Usage
Dim instance As TableCellCollection

instance.Clear
public void Clear ()
public:
virtual void Clear () sealed
public final void Clear ()
public final function Clear ()

Hinweise

Mit dieser Methode können Sie alle TableCell-Objekte aus TableCellCollection entfernen und die Count-Eigenschaft auf 0 festlegen.

Hinweis

Diese Methode entfernt die TableCell-Objekte aus TableCellCollection, sie entfernt aber TableRow nicht aus dem Table-Steuerelement. Stellen Sie sicher, dass auch TableRow entfernt wird, wenn Sie eine Zeile vollständig aus der Tabelle entfernen möchten.

Beispiel

Das folgende Beispiel veranschaulicht, wie mit der Clear-Methode alle TableCell-Objekte aus der mittleren Zeile der Tabelle entfernt und durch neue TableCell-Objekte ersetzt werden.

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

<html>
 <head>
 
    <script runat="server">
 
        Dim numrows As Integer = 5
        Dim numcells As Integer = 6
        Dim counter As Integer = 1
        
        Sub Page_Load(sender As Object, e As EventArgs)
            
            ' Create a table.
            Dim j As Integer
            For j = 0 To numrows - 1
                Dim r As New TableRow()
                Dim i As Integer
                For i = 0 To numcells - 1
                    Dim c As New TableCell()
                    c.Text = counter.ToString()
                    counter += 1
                    r.Cells.Add(c)
                Next i
                Table1.Rows.Add(r)
            Next j
        End Sub         

        Sub Button_Click(sender As Object, e As EventArgs)
            
            Table1.Rows(2).Cells.Clear()
            Dim i As Integer
            For i = 0 To numcells - 1
                Dim c As New TableCell()
                c.Text = "***"
                Table1.Rows(2).Cells.Add(c)
            Next i
        End Sub
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1"
            runat="server"/>
  
       <br>
 
       <center>
          <asp:Button id="Button1"
               Text="Replace Row 3 With ***"
               OnClick="Button_Click"
               runat="server"/>
       </center>
    </form>
 
 </body>
 </html>
 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <head>
 
    <script runat="server">
 
       int numrows = 5;
       int numcells = 6;
       int counter = 1;
 
       void Page_Load(Object sender, EventArgs e) 
       {
          
          // Create a table.
          for (int j=0; j<numrows; j++) 
          {          
             TableRow r = new TableRow();
             for (int i=0; i<numcells; i++) 
             {
                TableCell c = new TableCell();
                c.Text=counter.ToString();
                counter++;
                r.Cells.Add(c);
             }
             Table1.Rows.Add(r);
          }
 
       }
 
       void Button_Click(Object sender, EventArgs e) {
          
          Table1.Rows[2].Cells.Clear();
          for (int i=0; i<numcells; i++) 
          {
             TableCell c = new TableCell();
             c.Text="***";
             Table1.Rows[2].Cells.Add(c); 
          }
 
       }
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1"
            runat="server"/>
  
       <br>
 
       <center>
          <asp:Button id="Button1"
               Text="Replace Row 3 With ***"
               OnClick="Button_Click"
               runat="server"/>
       </center>
    </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

TableCellCollection-Klasse
TableCellCollection-Member
System.Web.UI.WebControls-Namespace
TableCell-Klasse
TableRow
Cells
Count

Weitere Ressourcen

Table-, TableRow- und TableCell-Webserver-Steuerelemente