HtmlTableRowCollection Classe

Referência

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

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.

Uma coleção de objetos HtmlTableRow que representam as linhas de um controle HtmlTable. Essa classe não pode ser herdada.

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

public sealed class HtmlTableRowCollection : System.Collections.ICollection

type HtmlTableRowCollection = class
    interface ICollection
    interface IEnumerable

Public NotInheritable Class HtmlTableRowCollection
Implements ICollection

Herança: Object
HtmlTableRowCollection

Implementações: ICollection IEnumerable

Exemplos

O exemplo de código a seguir demonstra como gerar dinamicamente o conteúdo de um HtmlTable controle adicionando linhas a uma coleção HtmlTableRowCollection . Observe que a Rows propriedade de uma tabela é o HtmlTableRowCollection objeto.

<%@ 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>HtmlTableRowCollection Example</title>
</head>
<body>

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

      <h3>HtmlTableRowCollection 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>HtmlTableRowCollection Example</title>
</head>
<body>

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

      <h3>HtmlTableRowCollection 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>

Comentários

Use a HtmlTableRowCollection classe para gerenciar programaticamente uma coleção de HtmlTableRow objetos que representam as linhas em um HtmlTable controle. Essa classe é comumente usada para adicionar, remover ou modificar o conteúdo de uma linha em um HtmlTable controle.

Observação

Um HtmlTable controle contém uma Rows propriedade que representa uma coleção de HtmlTableRow objetos. Cada HtmlTableRow uma representa uma linha individual na tabela. Um HtmlTableRow contém uma Cells propriedade que representa uma coleção de HtmlTableCell objetos. Esses objetos, por sua vez, representam as células individuais da tabela. Para recuperar uma célula individual, primeiro obtenha o HtmlTableRow objeto, representando a linha que contém a célula, da Rows coleção do HtmlTable controle. Em seguida, você pode obter o HtmlTableCell objeto, representando a célula na linha, da Cells coleção do HtmlTableRow.

Propriedades

Count	Obtém o número de objetos HtmlTableRow na coleção HtmlTableRowCollection.
IsReadOnly	Obtém um valor que indica se a coleção HtmlTableRowCollection é somente leitura.
IsSynchronized	Obtém um valor que indica se o acesso à coleção HtmlTableRowCollection é sincronizado (thread-safe).
Item[Int32]	Obtém o objeto HtmlTableRow no índice especificado da coleção HtmlTableRowCollection.
SyncRoot	Obtém o objeto que pode ser usado para sincronizar o acesso à coleção HtmlTableRowCollection.

Métodos

Add(HtmlTableRow)	Acrescenta o objeto HtmlTableRow especificado ao final da coleção HtmlTableRowCollection.
Clear()	Remove todos os objetos HtmlTableRow da coleção HtmlTableRowCollection.
CopyTo(Array, Int32)	Copia os itens da coleção HtmlTableRowCollection no objeto Array especificado, começando no índice especificado na matriz.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um objeto implementado por IEnumerator que contém todos os objetos HtmlTableRow na coleção HtmlTableRowCollection.
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)
Insert(Int32, HtmlTableRow)	Adiciona um objeto HtmlTableRow ao local especificado na coleção.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(HtmlTableRow)	Remove o objeto HtmlTableRow especificado da coleção HtmlTableRowCollection.
RemoveAt(Int32)	Remove o objeto HtmlTableRow no índice especificado da coleção HtmlTableRowCollection.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

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.

Aplica-se a