TableCellCollection TableCellCollection TableCellCollection TableCellCollection Class

定義

TableHeaderCell 控制項中構成列的 TableCellTable 物件的集合封裝。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.

注意

ATable控制項包含Rows集合,表示集合TableRow物件。A 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. 若要取得個別資料格,您必須先取得TableRowRows的集合Table控制項。To get an individual cell, you must first get a TableRow from the Rows collection of a Table control. 您可以取得TableCellCells的集合TableRowYou 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

取得表示是否同步 (Synchronize) (安全執行緒) 存取 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 加入在指定索引位置的 TableCellCollectionAdds 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,從 Array 中的指定索引開始。Copies 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 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

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

將指定的 TableCellTableCellCollection 中移除。Removes the specified TableCell from the TableCellCollection.

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

TableCell 從指定索引處的 TableCellCollection 移除。Removes 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.

Extension Methods

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)

將轉換IEnumerableIQueryableConverts an IEnumerable to an IQueryable.

適用於

另請參閱