TableCellCollection Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Encapsula una colección de objetos TableHeaderCell y TableCell que forman una fila en un control Table. Esta clase no puede heredarse.

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: Object
TableCellCollection

Implementaciones: ICollection IEnumerable IList

Ejemplos

En el ejemplo siguiente se muestra cómo rellenar un Table control mediante programación. TableCell Los objetos, que representan celdas individuales, se agregan a TableRow objetos , que representan las filas individuales, a través de la Cells propiedad .

<%@ 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 componen una fila en un Table control . Esta clase se usa normalmente para agregar o quitar celdas de una fila en un Table control .

Nota

Un Table control contiene una Rows colección que representa una colección de TableRow objetos . Cada TableRow una representa una fila individual de la tabla y contiene una Cells colección que representa una colección de TableCell objetos . Estos TableCell objetos representan las celdas individuales de la tabla. Para obtener una celda individual, primero debe obtener un TableRow elemento de la Rows colección de un Table control . A continuación, puede obtener un TableCell de la Cells colección de TableRow.

Propiedades

Count	Obtiene el número de objetos TableCell de la colección TableCellCollection.
IsReadOnly	Obtiene un valor que indica si TableCellCollection es de solo lectura.
IsSynchronized	Obtiene un valor que indica si el acceso a la TableCellCollection está sincronizado (es seguro para la ejecución de subprocesos).
Item[Int32]	Obtiene TableCell de TableCellCollection en el índice especificado.
SyncRoot	Obtiene el objeto que se puede utilizar para sincronizar el acceso a TableCellCollection.

Métodos

Add(TableCell)	Agrega el objeto TableCell especificado al final de TableCellCollection.
AddAt(Int32, TableCell)	Agrega el control TableCell especificado a TableCellCollection en la ubicación de índice especificada.
AddRange(TableCell[])	Agrega los objetos TableCell de la matriz especificada al final de la colección.
Clear()	Quita todos los objetos TableCell de la colección TableCellCollection.
CopyTo(Array, Int32)	Copia los elementos de TableCellCollection en el objeto Array especificado, empezando por el índice especificado en Array.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetCellIndex(TableCell)	Devuelve un valor que representa el índice del objeto TableCell especificado de TableCellCollection.
GetEnumerator()	Devuelve un objeto IEnumerator implementado que contiene todos los objetos TableCell de TableCellCollection.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(TableCell)	Quita el objeto TableCell especificado de TableCellCollection.
RemoveAt(Int32)	Quita un objeto TableCell de TableCellCollection en el índice especificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IList.Add(Object)	Agrega un objeto a la colección.
IList.Contains(Object)	Determina si el objeto especificado está contenido en la colección.
IList.IndexOf(Object)	Busca el objeto especificado y devuelve el índice de base cero de la primera aparición encontrada en la colección.
IList.Insert(Int32, Object)	Inserta un objeto en el índice especificado de la colección.
IList.IsFixedSize	Para obtener una descripción de este miembro, vea IsFixedSize.
IList.Item[Int32]	Para obtener una descripción de este miembro, vea Item[Int32].
IList.Remove(Object)	Quita un objeto de la colección.

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Compartir vía