HtmlTableRowCollection Klasse

Referenz

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Eine Auflistung von HtmlTableRow-Objekten, die die Zeilen eines HtmlTable-Steuerelements darstellen. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object
HtmlTableRowCollection

Implementiert: ICollection IEnumerable

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der Inhalt eines HtmlTable Steuerelements dynamisch generiert wird, indem Einer Auflistung Zeilen HtmlTableRowCollection hinzugefügt werden. Beachten Sie, dass die Rows -Eigenschaft einer Tabelle das HtmlTableRowCollection -Objekt ist.

<%@ 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>

Hinweise

Verwenden Sie die HtmlTableRowCollection -Klasse, um eine Auflistung von HtmlTableRow Objekten programmgesteuert zu verwalten, die die Zeilen in einem HtmlTable Steuerelement darstellen. Diese Klasse wird häufig verwendet, um den Inhalt einer Zeile in einem Steuerelement hinzuzufügen, zu entfernen oder zu HtmlTable ändern.

Hinweis

Ein HtmlTable Steuerelement enthält eine Rows -Eigenschaft, die eine Auflistung von HtmlTableRow -Objekten darstellt. Jede HtmlTableRow stellt eine einzelne Zeile in der Tabelle dar. Ein HtmlTableRow enthält eine Cells -Eigenschaft, die eine Auflistung von HtmlTableCell -Objekten darstellt. Diese Objekte stellen wiederum die einzelnen Zellen der Tabelle dar. Um eine einzelne Zelle abzurufen, rufen Sie zuerst das HtmlTableRow -Objekt ab, das die Zeile darstellt, die die Zelle enthält, aus der Rows Auflistung des Steuerelements HtmlTable . Anschließend können Sie das -Objekt, das HtmlTableCell die Zelle in der Zeile darstellt, aus der Cells Auflistung von HtmlTableRowabrufen.

Eigenschaften

Count	Ruft die Anzahl von HtmlTableRow-Objekten in der HtmlTableRowCollection-Auflistung ab.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die HtmlTableRowCollection-Auflistung schreibgeschützt ist.
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die HtmlTableRowCollection-Auflistung synchronisiert (threadsicher) ist.
Item[Int32]	Ruft das HtmlTableRow-Objekt am angegebenen Index aus der HtmlTableRowCollection-Auflistung ab.
SyncRoot	Ruft das Objekt ab, mit dem der Zugriff auf die HtmlTableRowCollection-Auflistung synchronisiert werden kann.

Methoden

Add(HtmlTableRow)	Fügt das angegebene HtmlTableRow-Objekt an das Ende der HtmlTableRowCollection-Auflistung an.
Clear()	Entfernt sämtliche HtmlTableRow-Objekte aus der HtmlTableRowCollection-Auflistung.
CopyTo(Array, Int32)	Kopiert die Elemente aus der HtmlTableRowCollection-Auflistung in das angegebene Array-Objekt, wobei am angegebenen Index des Arrays begonnen wird.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt ein implementiertes IEnumerator-Objekt zurück, das alle HtmlTableRow-Objekte in der HtmlTableRowCollection-Auflistung enthält.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Insert(Int32, HtmlTableRow)	Fügt der Auflistung an der angegebenen Position ein HtmlTableRow-Objekt hinzu.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(HtmlTableRow)	Entfernt das angegebene HtmlTableRow-Objekt aus der HtmlTableRowCollection-Auflistung.
RemoveAt(Int32)	Entfernt das HtmlTableRow-Objekt am angegebenen Index aus der HtmlTableRowCollection-Auflistung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Freigeben über