HtmlTableCellCollection 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 HtmlTableCell-Objekten, die die Zellen in einer einzelnen Zeile eines HtmlTable-Steuerelements darstellen. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object
HtmlTableCellCollection

Implementiert: ICollection IEnumerable

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der Inhalt eines HtmlTable Steuerelements dynamisch generiert wird, indem Zellen zu einer HtmlTableCellCollection Auflistung hinzugefügt werden. Beachten Sie, dass die Cells Eigenschaft einer Zeile, die durch ein HtmlTableRow Objekt dargestellt wird, die HtmlTableCellCollection Auflistung 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>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>

Hinweise

Verwenden Sie die HtmlTableCellCollection -Klasse, um eine Auflistung von HtmlTableCell Objekten programmgesteuert zu verwalten, die die Zellen einer einzelnen Zeile in einem HtmlTable Steuerelement darstellen. Diese Klasse wird häufig verwendet, um den Inhalt einer Zelle in einer Zeile eines HtmlTable Steuerelements hinzuzufügen, zu entfernen oder zu ändern.

Hinweis

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

Eigenschaften

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

Methoden

Add(HtmlTableCell)	Fügt das angegebene HtmlTableCell-Objekt an das Ende der HtmlTableCellCollection-Auflistung an.
Clear()	Entfernt sämtliche HtmlTableCell-Objekte aus der HtmlTableCellCollection-Auflistung.
CopyTo(Array, Int32)	Kopiert die Elemente aus der HtmlTableCellCollection-Auflistung in das angegebene Array. Dabei wird am angegebenen Index von Array begonnen.
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 HtmlTableCell-Objekte in der HtmlTableCellCollection-Auflistung enthält.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Insert(Int32, HtmlTableCell)	Fügt das angegebene HtmlTableCell-Objekt an der angegebenen Indexposition in der HtmlTableCellCollection-Auflistung ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(HtmlTableCell)	Entfernt das angegebene HtmlTableCell-Objekt aus der HtmlTableCellCollection-Auflistung.
RemoveAt(Int32)	Entfernt das HtmlTableCell-Objekt am angegebenen Index aus der HtmlTableCellCollection-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