TableCellCollection Класс

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инкапсулирует коллекцию TableHeaderCell и TableCell объекты, составляющие строку в элементе Table управления. Этот класс не может быть унаследован.

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>

Используйте этот класс для программного управления коллекцией объектов, составляющих TableCell строку в элементе Table управления. Этот класс обычно используется для добавления или удаления ячеек из строки в элементе Table управления.

Замечание

Элемент Table управления содержит Rows коллекцию, представляющую коллекцию TableRow объектов. Каждая TableRow строка представляет отдельную строку в таблице и содержит Cells коллекцию, представляющую коллекцию TableCell объектов. Эти TableCell объекты представляют отдельные ячейки в таблице. Чтобы получить отдельную ячейку, необходимо сначала получить TableRow из Rows коллекции Table элемента управления. Затем можно получить TableCell из Cells коллекции TableRow.

Свойства

Имя	Описание
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)	Удаляет объект из коллекции.

Методы расширения

Имя	Описание
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через