TableCellCollection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Encapsula uma coleção de objetos TableHeaderCell e TableCell que compõem uma linha em um controle Table. Essa classe não pode ser herdada.
public ref class TableCellCollection sealed : System::Collections::IListpublic sealed class TableCellCollection : System.Collections.IListtype TableCellCollection = class
interface IList
interface ICollection
interface IEnumerablePublic NotInheritable Class TableCellCollection
Implements IList- Herança
-
TableCellCollection
- Implementações
Exemplos
O exemplo a seguir demonstra como preencher programaticamente um Table controle. TableCell os objetos, que representam células individuais, são adicionados aos TableRow objetos, que representam as linhas individuais, por meio da Cells propriedade .
<%@ 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 coleção de TableCell objetos que compõem uma linha em um Table controle. Essa classe é comumente usada para adicionar ou remover células de uma linha em um Table controle.
Observação
Um Table controle contém uma Rows coleção que representa uma coleção de TableRow objetos. Cada TableRow um representa uma linha individual na tabela e contém uma Cells coleção que representa uma coleção de TableCell objetos. Esses TableCell objetos representam as células individuais na tabela. Para obter uma célula individual, primeiro você deve obter um TableRow da Rows coleção de um Table controle. Em seguida, você pode obter um TableCell da Cells coleção do TableRow.
Propriedades
| Count |
Obtém o número de objetos TableCell no TableCellCollection. |
| IsReadOnly |
Obtém um valor que indica se o TableCellCollection é somente leitura. |
| IsSynchronized |
Obtém um valor que indica se o acesso ao TableCellCollection é sincronizado (thread-safe). |
| Item[Int32] |
Obtém um TableCell do TableCellCollection no índice especificado. |
| SyncRoot |
Obtém o objeto que pode ser usado para sincronizar o acesso ao TableCellCollection. |
Métodos
| Add(TableCell) |
Acrescenta o TableCell especificado ao fim de TableCellCollection. |
| AddAt(Int32, TableCell) |
Adiciona o TableCell especificado ao TableCellCollection no local de índice especificado. |
| AddRange(TableCell[]) |
Acrescenta os objetos TableCell da matriz especificada ao final da coleção. |
| Clear() |
Remove todos os objetos TableCell de TableCellCollection. |
| CopyTo(Array, Int32) |
Copia os itens do TableCellCollection para o Array especificado, começando no índice especificado no Array. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetCellIndex(TableCell) |
Retorna um valor que representa o índice do TableCell especificado do TableCellCollection. |
| GetEnumerator() |
Retorna um objeto implementado IEnumerator que contém todos os objetos TableCell no TableCellCollection. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| Remove(TableCell) |
Remove o TableCell especificado do TableCellCollection. |
| RemoveAt(Int32) |
Remove um TableCell do TableCellCollection no índice especificado. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Implantações explícitas de interface
| IList.Add(Object) |
Adiciona um objeto à coleção. |
| IList.Contains(Object) |
Determina se o formato especificado está contido na coleção. |
| IList.IndexOf(Object) |
Pesquisa o objeto especificado e retorna o índice de base zero da primeira ocorrência dentro da coleção. |
| IList.Insert(Int32, Object) |
Insere um objeto na coleção no índice especificado. |
| IList.IsFixedSize |
Para obter uma descrição desse membro, confira IsFixedSize. |
| IList.Item[Int32] |
Para obter uma descrição desse membro, confira Item[Int32]. |
| IList.Remove(Object) |
Remove um objeto da coleção. |
Métodos de Extensão
| Cast<TResult>(IEnumerable) |
Converte os elementos de um IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base em um tipo especificado. |
| AsParallel(IEnumerable) |
Habilita a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable em um IQueryable. |
