TableCellCollection TableCellCollection TableCellCollection TableCellCollection Class

定义

封装 TableHeaderCellTableCell 对象的集合,这些对象组成了 Table 控件中的一行。Encapsulates a collection of TableHeaderCell and TableCell objects that make up a row in a Table control. 此类不能被继承。This class cannot be inherited.

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
继承
TableCellCollectionTableCellCollectionTableCellCollectionTableCellCollection
实现

示例

下面的示例演示如何以编程方式填充Table控件。The following example demonstrates how to programmatically fill a Table control. TableCell对象 (表示单个单元格) 添加到TableRow对象中, 这些对象表示各个行 ( Cells通过属性)。TableCell objects, which represent individual cells, are added to TableRow objects, which represent the individual rows, through the Cells property.

<%@ 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>

注解

使用此类以编程方式管理组成TableCell Table控件中的行的对象的集合。Use this class to programmatically manage a collection of TableCell objects that make up a row in a Table control. 此类通常用于在Table控件中的行中添加或删除单元。This class is commonly used to add or remove cells from a row in a Table control.

备注

控件包含一个Rows 集合TableRow , 该集合表示对象的集合。 TableA Table control contains a Rows collection that represents a collection of TableRow objects. TableRow个都表示表中的单个行并包含Cells一个表示TableCell对象集合的集合。Each TableRow represents an individual row in the table and contains a Cells collection that represents a collection of TableCell objects. 这些TableCell对象表示表中的单个单元格。These TableCell objects represent the individual cells in the table. 若要获取单个单元格, 你必须首先TableRow RowsTable控件的集合中获取。To get an individual cell, you must first get a TableRow from the Rows collection of a Table control. 然后, 可以TableCell Cells从的集合TableRow中获取。You can then get a TableCell from the Cells collection of the TableRow.

属性

Count Count Count Count

获取 TableCell 中的 TableCellCollection 对象数。Gets the number of TableCell objects in the TableCellCollection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

获取一个值,该值指示 TableCellCollection 是否为只读。Gets a value indicating whether the TableCellCollection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

获取一个值,该值指示是否同步 TableCellCollection 访问(线程安全)。Gets a value indicating whether access to the TableCellCollection is synchronized (thread-safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

TableCell 中获取位于指定索引位置的 TableCellCollectionGets a TableCell from the TableCellCollection at the specified index.

SyncRoot SyncRoot SyncRoot SyncRoot

获取可用于同步 TableCellCollection 访问的对象。Gets the object that can be used to synchronize access to the TableCellCollection.

方法

Add(TableCell) Add(TableCell) Add(TableCell) Add(TableCell)

将指定的 TableCell 追加到 TableCellCollection 的末尾。Appends the specified TableCell to the end of the TableCellCollection.

AddAt(Int32, TableCell) AddAt(Int32, TableCell) AddAt(Int32, TableCell) AddAt(Int32, TableCell)

将指定的 TableCell 添加到 TableCellCollection 中的指定索引位置。Adds the specified TableCell to the TableCellCollection at the specified index location.

AddRange(TableCell[]) AddRange(TableCell[]) AddRange(TableCell[]) AddRange(TableCell[])

TableCell 对象从指定的数组追加到集合的末尾。Appends the TableCell objects from the specified array to the end of the collection.

Clear() Clear() Clear() Clear()

TableCell 中移除所有 TableCellCollection 对象。Removes all TableCell objects from the TableCellCollection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

TableCellCollection 中的指定索引开始,将 Array 中的项复制到指定的 ArrayCopies the items from the TableCellCollection to the specified Array, starting with the specified index in the Array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCellIndex(TableCell) GetCellIndex(TableCell) GetCellIndex(TableCell) GetCellIndex(TableCell)

返回一个值,该值表示 TableCell 中指定 TableCellCollection 的索引。Returns a value that represents the index of the specified TableCell from the TableCellCollection.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

返回一个实现了 IEnumerator 的对象,该对象包含 TableCell 中的所有 TableCellCollection 对象。Returns a IEnumerator implemented object that contains all TableCell objects in the TableCellCollection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

获取当前实例的 TypeGets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(TableCell) Remove(TableCell) Remove(TableCell) Remove(TableCell)

TableCell 中移除指定的 TableCellCollectionRemoves the specified TableCell from the TableCellCollection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

TableCell 中移除位于指定索引位置的 TableCellCollectionRemoves a TableCell from the TableCellCollection at the specified index.

ToString() ToString() ToString() ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(Inherited from Object)

显式界面实现

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

将对象添加到集合。Adds an object to the collection.

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

确定指定对象是否位于集合内。Determines whether the specified object is contained within the collection.

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

搜索指定的对象,并返回集合中第一个匹配项的从零开始的索引。Searches for the specified object and returns the zero-based index of the first occurrence within the collection.

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

将对象插入到集合中的指定索引处。Inserts an object into the collection at the specified index.

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

有关此成员的说明,请参见 IsFixedSizeFor a description of this member, see IsFixedSize.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

有关此成员的说明,请参见 Item[Int32]For a description of this member, see Item[Int32].

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

从集合中移除一个对象。Removes an object from the collection.

扩展方法

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

IEnumerable 的元素强制转换为指定的类型。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

根据指定类型筛选 IEnumerable 的元素。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

启用查询的并行化。Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

IEnumerable 转换为 IQueryableConverts an IEnumerable to an IQueryable.

适用于

另请参阅