TableCellCollection Clase

Definición

Encapsula una colección de objetos TableHeaderCell y TableCell que forman una fila en un control Table.Encapsulates a collection of TableHeaderCell and TableCell objects that make up a row in a Table control. Esta clase no puede heredarse.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
Herencia
TableCellCollection
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo rellenar Table un control mediante programación.The following example demonstrates how to programmatically fill a Table control. TableCelllos objetos, que representan celdas individuales, se agregan a TableRow los objetos, que representan las filas individuales, a través de la Cells propiedad.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>

Comentarios

Utilice esta clase para administrar mediante programación una colección de TableCell objetos que constituyen una fila de un Table control.Use this class to programmatically manage a collection of TableCell objects that make up a row in a Table control. Esta clase se usa normalmente para agregar o quitar celdas de una fila de un Table control.This class is commonly used to add or remove cells from a row in a Table control.

Nota

Un Table control contiene una Rows colección que representa una colección de TableRow objetos.A Table control contains a Rows collection that represents a collection of TableRow objects. Cada TableRow representa una fila individual de la tabla y contiene una Cells colección que representa una colección de TableCell objetos.Each TableRow represents an individual row in the table and contains a Cells collection that represents a collection of TableCell objects. Estos TableCell objetos representan las celdas individuales de la tabla.These TableCell objects represent the individual cells in the table. Para obtener una celda individual, primero debe obtener un TableRow de la Rows colección de un Table control.To get an individual cell, you must first get a TableRow from the Rows collection of a Table control. A continuación, puede obtener TableCell un de Cells la colección de TableRow.You can then get a TableCell from the Cells collection of the TableRow.

Propiedades

Count

Obtiene el número de objetos TableCell que hay en la colección TableCellCollection.Gets the number of TableCell objects in the TableCellCollection.

IsReadOnly

Obtiene un valor que indica si TableCellCollection es de solo lectura.Gets a value indicating whether the TableCellCollection is read-only.

IsSynchronized

Obtiene un valor que indica si el acceso a TableCellCollection está sincronizado (es seguro para la ejecución de subprocesos).Gets a value indicating whether access to the TableCellCollection is synchronized (thread-safe).

Item[Int32]

Obtiene TableCell de TableCellCollection en el índice especificado.Gets a TableCell from the TableCellCollection at the specified index.

SyncRoot

Obtiene el objeto que se puede utilizar para sincronizar el acceso a TableCellCollection.Gets the object that can be used to synchronize access to the TableCellCollection.

Métodos

Add(TableCell)

Agrega el objeto TableCell especificado al final de TableCellCollection.Appends the specified TableCell to the end of the TableCellCollection.

AddAt(Int32, TableCell)

Agrega el control TableCell especificado a TableCellCollection en la ubicación de índice especificada.Adds the specified TableCell to the TableCellCollection at the specified index location.

AddRange(TableCell[])

Agrega los objetos TableCell de la matriz especificada al final de la colección.Appends the TableCell objects from the specified array to the end of the collection.

Clear()

Quita todos los objetos TableCell de la colección TableCellCollection.Removes all TableCell objects from the TableCellCollection.

CopyTo(Array, Int32)

Copia los elementos de TableCellCollection en el objeto Array especificado, empezando por el índice especificado en Array.Copies the items from the TableCellCollection to the specified Array, starting with the specified index in the Array.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetCellIndex(TableCell)

Devuelve un valor que representa el índice del objeto TableCell especificado de TableCellCollection.Returns a value that represents the index of the specified TableCell from the TableCellCollection.

GetEnumerator()

Devuelve un objeto IEnumerator implementado que contiene todos los objetos TableCell de TableCellCollection.Returns a IEnumerator implemented object that contains all TableCell objects in the TableCellCollection.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(TableCell)

Quita el objeto TableCell especificado de TableCellCollection.Removes the specified TableCell from the TableCellCollection.

RemoveAt(Int32)

Quita un objeto TableCell de TableCellCollection en el índice especificado.Removes a TableCell from the TableCellCollection at the specified index.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IList.Add(Object)

Agrega un objeto a la colección.Adds an object to the collection.

IList.Contains(Object)

Determina si el objeto especificado está contenido en la colección.Determines whether the specified object is contained within the collection.

IList.IndexOf(Object)

Busca el objeto especificado y devuelve el índice de base cero de la primera aparición encontrada en la colección.Searches for the specified object and returns the zero-based index of the first occurrence within the collection.

IList.Insert(Int32, Object)

Inserta un objeto en el índice especificado de la colección.Inserts an object into the collection at the specified index.

IList.IsFixedSize

Para obtener una descripción de este miembro, vea IsFixedSize.For a description of this member, see IsFixedSize.

IList.Item[Int32]

Para obtener una descripción de este miembro, vea Item[Int32].For a description of this member, see Item[Int32].

IList.Remove(Object)

Quita un objeto de la colección.Removes an object from the collection.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: