TableCellCollection 类

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

封装在 Table 控件中组成一个行的 TableHeaderCell 和 TableCell 对象的集合。此类不能被继承。

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

继承: Object
TableCellCollection

实现: ICollection IEnumerable IList

示例

以下示例演示如何以编程方式填充 Table 控件。 TableCell 对象（表示单个单元格）通过属性添加到 TableRow 表示单个行 Cells 的对象中。

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

注解

使用此类以编程方式管理构成控件中Table行的对象集合TableCell。此类通常用于在控件中的 Table 行中添加或删除单元格。

备注

控件 Table 包含一个 Rows 表示对象集合的 TableRow 集合。每个 TableRow 表示表中的单个行，并包含一个 Cells 代表对象集合的 TableCell 集合。这些 TableCell 对象表示表中的各个单元格。若要获取单个单元格，必须先从Rows控件的集合中获取一个TableRow Table单元格。然后，可以从集合TableRow中获取。Cells TableCell

属性

Count	获取 TableCell 中 TableCellCollection 对象的数目。
IsReadOnly	获取一个值，该值指示 TableCellCollection 是否为只读。
IsSynchronized	获取一个值，该值指示是否同步对 TableCellCollection 的访问（线程安全）。
Item[Int32]	从 TableCell 中获取位于指定索引位置的 TableCellCollection。
SyncRoot	获取可用于同步 TableCellCollection 访问的对象。

方法

Add(TableCell)	将指定的 TableCell 追加到 TableCellCollection 的末尾。
AddAt(Int32, TableCell)	将指定的 TableCell 添加到 TableCellCollection 中的指定索引位置。
AddRange(TableCell[])	将 TableCell 对象从指定的数组追加到集合的末尾。
Clear()	从 TableCell 中移除所有 TableCellCollection 对象。
CopyTo(Array, Int32)	从 TableCellCollection 中的指定索引开始，将 Array 中的项复制到指定的 Array。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetCellIndex(TableCell)	返回一个值，该值表示 TableCell 中指定 TableCellCollection 的索引。
GetEnumerator()	返回一个实现了 IEnumerator 的对象，该对象包含 TableCell 中的所有 TableCellCollection 对象。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(TableCell)	从 TableCell 中移除指定的 TableCellCollection。
RemoveAt(Int32)	从 TableCell 中移除位于指定索引位置的 TableCellCollection。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IList.Add(Object)	将对象添加到集合。
IList.Contains(Object)	确定指定对象是否位于集合内。
IList.IndexOf(Object)	搜索指定的对象，并返回集合中第一个匹配项的从零开始的索引。
IList.Insert(Int32, Object)	将对象插入到集合中的指定索引处。
IList.IsFixedSize	有关此成员的说明，请参见 IsFixedSize。
IList.Item[Int32]	有关此成员的说明，请参见 Item[Int32]。
IList.Remove(Object)	从集合中移除一个对象。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

适用于

TableCellCollection 类

定义

示例

注解

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

其他资源