TableCellCollection Klasse

  • Referenz

Definition

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

Kapselt eine Auflistung von TableHeaderCell- und TableCell-Objekten, die eine Zeile in einem Table-Steuerelement darstellen. Diese Klasse kann nicht vererbt werden.

public ref class TableCellCollection sealed : System::Collections::IList
public sealed class TableCellCollection : System.Collections.IList
type TableCellCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class TableCellCollection
Implements IList
Vererbung
Object
TableCellCollection
Implementiert
ICollection IEnumerable IList

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Table Steuerelement programmgesteuert ausgefüllt wird. TableCell-Objekte, die einzelne Zellen darstellen, werden objekten, die die einzelnen Zeilen darstellen, über die Cells -Eigenschaft hinzugefügtTableRow.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    private void Page_Load(Object sender, EventArgs e) 
    {
        // Generate rows and cells.           
        int numrows = 4;
        int numcells = 6;
        int counter = 1;
        for (int rowNum = 0; rowNum < numrows; rowNum++) 
        {          
            TableRow rw = new TableRow();
            for (int cellNum = 0; cellNum < numcells; cellNum++) 
            {
                TableCell cel = new TableCell();
                cel.Text=counter.ToString();
                counter++;
                rw.Cells.Add(cel);
            }
            Table1.Rows.Add(rw);
        }
    }
 
    private void Button_Click_Coord(object sender, EventArgs e) 
    {
        for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++) 
        {          
            for (int cellNum = 0; cellNum < 
                Table1.Rows[rowNum].Cells.Count; cellNum++) 
            {
                Table1.Rows[rowNum].Cells[cellNum].Text = 
                    String.Format("(Row{0}, Cell{1})", rowNum, cellNum);
            }
        }
    }

    private void Button_Click_Number(object sender, EventArgs e) 
    {
        int counter = 1;
          
        for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++) 
        {
            for (int cellNum = 0; cellNum < 
                Table1.Rows[rowNum].Cells.Count; cellNum++) 
            {
                Table1.Rows[rowNum].Cells[cellNum].Text = 
                    counter.ToString();
                counter++;
            }            
        }
    }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TableCellCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TableCellCollection Example</h3>
       <asp:Table id="Table1" 
            runat="server"/>
       <br />
       <center>
          <asp:Button id="Button1"
               Text="Display Table Coordinates"
               OnClick="Button_Click_Coord"
               runat="server"/>
          <asp:Button id="Button2"
               Text="Display Cell Numbers"
               OnClick="Button_Click_Number"
               runat="server"/>
       </center>
 
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Private Sub Page_Load(sender As Object, e As EventArgs)
        ' Generate rows and cells.           
        Dim numrows As Integer = 4
        Dim numcells As Integer = 6
        Dim counter As Integer = 1
        Dim rowNum As Integer
        Dim cellNum As Integer
        For rowNum = 0 To numrows - 1
            Dim rw As New TableRow()
            For cellNum = 0 To numcells - 1
                Dim cel As New TableCell()
                cel.Text = counter.ToString()
                counter += 1
                rw.Cells.Add(cel)
            Next
            Table1.Rows.Add(rw)
        Next
    End Sub

    Private Sub Button_Click_Coord(sender As Object, e As EventArgs)            
        Dim rowNum As Integer
        Dim cellNum As Integer
        Dim rowCount As Integer
        For rowCount = 0 To Table1.Rows.Count - 1
            For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1                    
                Table1.Rows(rowNum).Cells(cellNum).Text = _
                    String.Format("(Row{0}, Cell{1})", rowNum, cellNum)
            Next
        Next
    End Sub

    Private Sub Button_Click_Number(sender As Object, e As EventArgs)
        Dim counter As Integer = 1

        Dim rowNum As Integer
        Dim cellNum As Integer
        For rowNum = 0 To Table1.Rows.Count - 1
            For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1                    
                Table1.Rows(rowNum).Cells(cellNum).Text = _
                    counter.ToString()
                counter += 1
            Next 
        Next
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TableCellCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TableCellCollection Example</h3>
       <asp:Table id="Table1" 
            runat="server"/>
       <br />
       <center>
          <asp:Button id="Button1"
               Text="Display Table Coordinates"
               OnClick="Button_Click_Coord"
               runat="server"/>
          <asp:Button id="Button2"
               Text="Display Cell Numbers"
               OnClick="Button_Click_Number"
               runat="server"/>
       </center>
 
    </div>
    </form>
</body>
</html>

Hinweise

Verwenden Sie diese Klasse, um eine Auflistung von TableCell Objekten programmgesteuert zu verwalten, die eine Zeile in einem Table Steuerelement bilden. Diese Klasse wird häufig zum Hinzufügen oder Entfernen von Zellen aus einer Zeile in einem Table Steuerelement verwendet.

Hinweis

Ein Table Steuerelement enthält eine Rows Auflistung, die eine Auflistung von TableRow -Objekten darstellt. Jede TableRow stellt eine einzelne Zeile in der Tabelle dar und enthält eine Cells Auflistung, die eine Auflistung von TableCell -Objekten darstellt. Diese TableCell Objekte stellen die einzelnen Zellen in der Tabelle dar. Um eine einzelne Zelle abzurufen, müssen Sie zuerst eine TableRow aus der Rows Auflistung eines Steuerelements Table abrufen. Sie können dann eine TableCell aus der Cells Auflistung des TableRowabrufen.

Eigenschaften

Count

Ruft die Anzahl der TableCell-Objekte in TableCellCollection ab.
IsReadOnly

Ruft einen Wert ab, der angibt, ob das TableCellCollection schreibgeschützt ist.
IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die TableCellCollection synchronisiert (threadsicher) ist.
Item[Int32]

Ruft TableCell am angegebenen Index aus TableCellCollection ab.
SyncRoot

Ruft das Objekt ab, mit dem der Zugriff auf TableCellCollection synchronisiert werden kann.

Methoden

Add(TableCell)

Fügt die angegebene TableCell an das Ende der TableCellCollection an.
AddAt(Int32, TableCell)

Fügt die angegebene TableCell an der angegebenen Indexposition in TableCellCollection ein.
AddRange(TableCell[])

Fügt die TableCell-Objekte aus dem angegebenen Array an das Ende der Auflistung an.
Clear()

Entfernt alle TableCell-Objekte aus der TableCellCollection.
CopyTo(Array, Int32)

Kopiert die Elemente aus TableCellCollection in das angegebene Array, wobei am angegebenen Index in Array begonnen wird.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetCellIndex(TableCell)

Gibt einen Wert zurück, der den Index der angegebenen TableCell aus TableCellCollection darstellt.
GetEnumerator()

Gibt ein IEnumerator-implementiertes Objekt zurück, das alle TableCell-Objekte in TableCellCollection enthält.
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Remove(TableCell)

Entfernt die angegebene TableCell aus der TableCellCollection.
RemoveAt(Int32)

Entfernt eine TableCell am angegebenen Index aus TableCellCollection.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IList.Add(Object)

Fügt der Auflistung ein Objekt hinzu.
IList.Contains(Object)

Bestimmt, ob das angegebene Objekt in der Auflistung enthalten ist.
IList.IndexOf(Object)

Sucht nach dem angegebenen Objekt und gibt den nullbasierten Index des ersten Vorkommens in der Auflistung zurück.
IList.Insert(Int32, Object)

Fügt ein Objekt am angegebenen Index in die Auflistung ein.
IList.IsFixedSize

Eine Beschreibung dieses Elements finden Sie unter IsFixedSize.
IList.Item[Int32]

Eine Beschreibung dieses Elements finden Sie unter Item[Int32].
IList.Remove(Object)

Entfernt ein Objekt aus der Auflistung.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Weitere Informationen