TableCellCollection Classe

Definição

Encapsula uma coleção de objetos TableHeaderCell e TableCell que compõem uma linha em um controle Table.Encapsulates a collection of TableHeaderCell and TableCell objects that make up a row in a Table control. Essa classe não pode ser herdada.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
Herança
TableCellCollection
Implementações

Exemplos

O exemplo a seguir demonstra como preencher um Table controle programaticamente.The following example demonstrates how to programmatically fill a Table control. TableCellobjetos, que representam células individuais, são adicionados a TableRow objetos, que representam as linhas individuais, por meio Cells da propriedade.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>

Comentários

Use essa classe para gerenciar programaticamente uma TableCell coleção de objetos que compõem uma linha Table em um controle.Use this class to programmatically manage a collection of TableCell objects that make up a row in a Table control. Essa classe é normalmente usada para adicionar ou remover células de uma linha em um Table controle.This class is commonly used to add or remove cells from a row in a Table control.

Observação

Um Table controle contém uma Rows coleção que representa uma coleção de TableRow objetos.A Table control contains a Rows collection that represents a collection of TableRow objects. Cada TableRow representa uma linha individual na tabela e contém uma Cells coleção que representa uma coleção de TableCell objetos.Each TableRow represents an individual row in the table and contains a Cells collection that represents a collection of TableCell objects. Esses TableCell objetos representam as células individuais na tabela.These TableCell objects represent the individual cells in the table. Para obter uma célula individual, você deve primeiro obter uma TableRow Rows da coleção de um Table controle.To get an individual cell, you must first get a TableRow from the Rows collection of a Table control. Em seguida, você pode TableCell obter um Cells da coleção do TableRow.You can then get a TableCell from the Cells collection of the TableRow.

Propriedades

Count

Obtém o número de objetos TableCell no TableCellCollection.Gets the number of TableCell objects in the TableCellCollection.

IsReadOnly

Obtém um valor que indica se o TableCellCollection é somente leitura.Gets a value indicating whether the TableCellCollection is read-only.

IsSynchronized

Obtém um valor que indica se o acesso ao TableCellCollection é sincronizado (thread-safe).Gets a value indicating whether access to the TableCellCollection is synchronized (thread-safe).

Item[Int32]

Obtém um TableCell do TableCellCollection no índice especificado.Gets a TableCell from the TableCellCollection at the specified index.

SyncRoot

Obtém o objeto que pode ser usado para sincronizar o acesso ao TableCellCollection.Gets the object that can be used to synchronize access to the TableCellCollection.

Métodos

Add(TableCell)

Acrescenta o TableCell especificado ao fim de TableCellCollection.Appends the specified TableCell to the end of the TableCellCollection.

AddAt(Int32, TableCell)

Adiciona o TableCell especificado ao TableCellCollection no local de índice especificado.Adds the specified TableCell to the TableCellCollection at the specified index location.

AddRange(TableCell[])

Acrescenta os objetos TableCell da matriz especificada ao final da coleção.Appends the TableCell objects from the specified array to the end of the collection.

Clear()

Remove todos os objetos TableCell de TableCellCollection.Removes all TableCell objects from the TableCellCollection.

CopyTo(Array, Int32)

Copia os itens do TableCellCollection para o Array especificado, começando no índice especificado no Array.Copies the items from the TableCellCollection to the specified Array, starting with the specified index in the Array.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetCellIndex(TableCell)

Retorna um valor que representa o índice do TableCell especificado do TableCellCollection.Returns a value that represents the index of the specified TableCell from the TableCellCollection.

GetEnumerator()

Retorna um objeto implementado IEnumerator que contém todos os objetos TableCell no TableCellCollection.Returns a IEnumerator implemented object that contains all TableCell objects in the TableCellCollection.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Remove(TableCell)

Remove o TableCell especificado do TableCellCollection.Removes the specified TableCell from the TableCellCollection.

RemoveAt(Int32)

Remove um TableCell do TableCellCollection no índice especificado.Removes a TableCell from the TableCellCollection at the specified index.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IList.Add(Object)

Adiciona um objeto à coleção.Adds an object to the collection.

IList.Contains(Object)

Determina se o formato especificado está contido na coleção.Determines whether the specified object is contained within the collection.

IList.IndexOf(Object)

Pesquisa o objeto especificado e retorna o índice de base zero da primeira ocorrência dentro da coleção.Searches for the specified object and returns the zero-based index of the first occurrence within the collection.

IList.Insert(Int32, Object)

Insere um objeto na coleção no índice especificado.Inserts an object into the collection at the specified index.

IList.IsFixedSize

Para obter uma descrição desse membro, consulte IsFixedSize.For a description of this member, see IsFixedSize.

IList.Item[Int32]

Para obter uma descrição desse membro, consulte Item[Int32].For a description of this member, see Item[Int32].

IList.Remove(Object)

Remove um objeto da coleção.Removes an object from the collection.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também