HtmlTableCellCollection Classe

Definição

Espaço de Nomes:: System.Web.UI.HtmlControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Uma coleção de HtmlTableCell objetos que representam as células numa única linha de um HtmlTable controlo. Esta classe não pode ser herdada.

public ref class HtmlTableCellCollection sealed : System::Collections::ICollection

public sealed class HtmlTableCellCollection : System.Collections.ICollection

type HtmlTableCellCollection = class
    interface ICollection
    interface IEnumerable

Public NotInheritable Class HtmlTableCellCollection
Implements ICollection

Herança: Object
HtmlTableCellCollection

Implementações: ICollection IEnumerable

Exemplos

O exemplo de código seguinte demonstra como gerar dinamicamente o conteúdo de um HtmlTable controlo adicionando células a uma HtmlTableCellCollection coleção. Note que a Cells propriedade de uma linha, representada por um HtmlTableRow objeto, é a HtmlTableCellCollection coleção.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {

    // Get the number of rows and columns selected by the user.
    int numrows = Convert.ToInt32(Select1.Value);
    int numcells = Convert.ToInt32(Select2.Value);

    // Iterate through the rows.
    for (int j = 0; j < numrows; j++)
    {

      // Create a new row and add it to the Rows collection.
      HtmlTableRow row = new HtmlTableRow();

      // Provide a different background color for alternating rows.
      if (j % 2 == 1)
        row.BgColor = "Gray";

      // Iterate through the cells of a row.
      for (int i = 0; i < numcells; i++)
      {
        // Create a new cell and add it to the Cells collection.
        HtmlTableCell cell = new HtmlTableCell();
        cell.Controls.Add(new LiteralControl("row " +
                          j.ToString() +
                          ", cell " +
                          i.ToString()));
        row.Cells.Add(cell);
      }
      Table1.Rows.Add(row);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTableCellCollection Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>HtmlTableCellCollection Example</h3>

      <table id="Table1" 
             style="border-width:1; border-color:Black; padding:5"
             cellspacing="0" 
             runat="server"/>
        
      <hr />

      Select the number of rows and columns to create: <br /><br />

      Table rows:
      <select id="Select1" 
              runat="server">

         <option value="1">1</option>
         <option value="2">2</option>
         <option value="3">3</option>
         <option value="4">4</option>
         <option value="5">5</option>

      </select>

        

      Table cells:
      <select id="Select2" 
              runat="server">

         <option value="1">1</option>
         <option value="2">2</option>
         <option value="3">3</option>
         <option value="4">4</option>
         <option value="5">5</option>

      </select>
       
      <br /><br />
  
      <input type="submit" 
             value="Generate Table" 
             runat="server"/>

   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    Dim i As Integer
    Dim j As Integer
    Dim row As HtmlTableRow
    Dim cell As HtmlTableCell

    ' Get the number of rows and columns selected by the user.
    Dim numrows As Integer = CInt(Select1.Value)
    Dim numcells As Integer = CInt(Select2.Value)

    ' Iterate through the rows.
    For j = 0 To numrows - 1

      ' Create a new row and add it to the Rows collection.
      row = New HtmlTableRow()

      ' Provide a different background color for alternating rows.
      If (j Mod 2) = 1 Then
        row.BgColor = "Gray"
      End If

      ' Iterate through the cells of a row.
      For i = 0 To numcells - 1
           
        ' Create a new cell and add it to the Cells collection.
        cell = New HtmlTableCell()
        cell.Controls.Add(New LiteralControl("row " & _
                          j.ToString() & _
                          ", cell " & _
                          i.ToString()))
        row.Cells.Add(cell)
            
      Next i

      Table1.Rows.Add(row)
         
    Next j
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTableCellCollection Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>HtmlTableCellCollection Example</h3>

      <table id="Table1" 
             style="border-width:1; border-color:Black; padding:5"
             cellspacing="0" 
             runat="server"/>
        
      <hr />

      Select the number of rows and columns to create: <br /><br />

      Table rows:
      <select id="Select1" 
              runat="server">

         <option value="1">1</option>
         <option value="2">2</option>
         <option value="3">3</option>
         <option value="4">4</option>
         <option value="5">5</option>

      </select>

        

      Table cells:
      <select id="Select2" 
              runat="server">

         <option value="1">1</option>
         <option value="2">2</option>
         <option value="3">3</option>
         <option value="4">4</option>
         <option value="5">5</option>

      </select>
       
      <br /><br />
  
      <input type="submit" 
             value="Generate Table" 
             runat="server"/>

   </form>

</body>
</html>

Observações

Use a HtmlTableCellCollection classe para gerir programaticamente uma coleção de HtmlTableCell objetos que representam as células de uma única linha num HtmlTable controlo. Esta classe é comumente usada para adicionar, remover ou modificar o conteúdo de uma célula numa linha de um HtmlTable controlo.

Note

Um HtmlTable controlo contém uma Rows propriedade que contém uma coleção de HtmlTableRow objetos. Cada HtmlTableRow objeto representa uma linha individual na tabela. Um HtmlTableRow objeto contém uma Cells propriedade que representa uma coleção de HtmlTableCell objetos. Estes objetos, por sua vez, representam as células individuais de uma linha. Para recuperar uma célula individual, primeiro obtenha o HtmlTableRow objeto que representa a linha que contém a célula na tabela (da Rows coleção do HtmlTable controlo). Depois podes obter o HtmlTableCell objeto que representa a célula na linha (da Cells coleção do HtmlTableRow objeto).

Propriedades

Name	Description
Count	Obtém o número de HtmlTableCell objetos na HtmlTableCellCollection coleção.
IsReadOnly	Recebe um valor que indica se a HtmlTableCellCollection coleção é apenas de leitura.
IsSynchronized	Recebe um valor que indica se o acesso à HtmlTableCellCollection coleção está sincronizado (thread safe).
Item[Int32]	Obtém o HtmlTableCell objeto no índice especificado da HtmlTableCellCollection coleção.
SyncRoot	Obtém o objeto que pode ser usado para sincronizar o acesso à HtmlTableCellCollection coleção.

Métodos

Name	Description
Add(HtmlTableCell)	Acrescenta o objeto especificado HtmlTableCell ao final da HtmlTableCellCollection coleção.
Clear()	Remove todos HtmlTableCell os objetos da HtmlTableCellCollection coleção.
CopyTo(Array, Int32)	Copia os itens da HtmlTableCellCollection coleção para o especificado Array, começando pelo índice especificado no Array.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Devolve um IEnumeratorobjeto -implementado que contém todos HtmlTableCell os objetos da HtmlTableCellCollection coleção.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Insert(Int32, HtmlTableCell)	Adiciona o objeto especificado HtmlTableCell na localização de índice especificada da HtmlTableCellCollection coleção.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
Remove(HtmlTableCell)	Remove o objeto especificado HtmlTableCell da HtmlTableCellCollection coleção.
RemoveAt(Int32)	Remove o HtmlTableCell objeto no índice especificado da HtmlTableCellCollection coleção.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Métodos da Extensão

Name	Description
AsParallel(IEnumerable)	Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)	Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?