Freigeben über


HtmlTableRowCollection.GetEnumerator-Methode

Gibt ein implementiertes System.Collections.IEnumerator-Objekt zurück, das alle HtmlTableRow-Objekte in der HtmlTableRowCollection-Auflistung enthält.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Function GetEnumerator As IEnumerator
'Usage
Dim instance As HtmlTableRowCollection
Dim returnValue As IEnumerator

returnValue = instance.GetEnumerator
public IEnumerator GetEnumerator ()
public:
virtual IEnumerator^ GetEnumerator () sealed
public final IEnumerator GetEnumerator ()
public final function GetEnumerator () : IEnumerator

Rückgabewert

Ein implementiertes System.Collections.IEnumerator-Objekt, das alle HtmlTableRow-Objekte in der HtmlTableRowCollection enthält.

Hinweise

Mit dieser Methode können Sie ein implementiertes System.Collections.IEnumerator-Objekt erstellen, das durchlaufen werden kann, um jedes Element in der HtmlTableRowCollection-Auflistung abzurufen.

Mit der IEnumerator.Current-Eigenschaft können Sie das aktuelle Element in der Auflistung abrufen.

Mit der IEnumerator.MoveNext-Methode können Sie zum nächsten Element in der Auflistung wechseln.

Mit der IEnumerator.Reset-Methode verschieben Sie den Enumerator an die Anfangsposition.

Hinweis

Sie müssen die IEnumerator.MoveNext-Methode aufrufen, nachdem ein implementiertes System.Collections.IEnumerator-Objekt erstellt oder der Enumerator mit der IEnumerator.Reset-Methode zum ersten Element in der Auflistung verschoben wurde. Andernfalls ist das durch die IEnumerator.Current-Eigenschaft dargestellte Element nicht definiert.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der GetEnumerator-Methode ein System.Collections.IEnumerator-Objekt erstellt wird. Anschließend wird das System.Collections.IEnumerator-Objekt durchlaufen, um den Inhalt der HtmlTableRowCollection-Auflistung anzuzeigen.

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

<script runat="server">

  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
 
    Dim current_row As HtmlTableRow

    ' Create an IEnumerator enumerator.
    Dim myEnum As IEnumerator = Table1.Rows.GetEnumerator()

    Span1.InnerText = "The items in the rows of the table are: "

    ' Iterate through the IEnumerator and display its contents.
    While myEnum.MoveNext()
         
      current_row = CType(myEnum.Current, HtmlTableRow)
      Span1.InnerText = Span1.InnerText & " " & current_row.Cells(0).InnerText & _
                        " " & current_row.Cells(1).InnerText

    End While

  End Sub

</script>

<html>
<head>
   <title>HtmlTableRowCollection Example</title>
</head>
<body>

   <form runat="server">

      <h3>HtmlTableRowCollection Example</h3>

      <table id="Table1" 
             border="1" 
             bordercolor="black" 
             runat="server">

         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
         </tr>
         <tr>
            <td>
               Cell 3
            </td>
            <td>
               Cell 4
            </td>
         </tr>

      </table>


      <br><br>
  
      <input type="button" 
             value="Display row contents in the table"
             onserverclick="Button_Click" 
             runat="server"/>

      <br><br>

      <span id="Span1"
            runat="server"/>

   </form>

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

<script runat="server">

  void Button_Click(Object sender, EventArgs e)
  {

    HtmlTableRow current_row;

    // Create an IEnumerator enumerator.
    IEnumerator myEnum = Table1.Rows.GetEnumerator();

    Span1.InnerText = "The items in the rows of the table are: ";

    // Iterate through the IEnumerator and display its contents.
    while (myEnum.MoveNext())
    {

      current_row = (HtmlTableRow)myEnum.Current;
      Span1.InnerText = Span1.InnerText + " " + current_row.Cells[0].InnerText +
                        " " + current_row.Cells[1].InnerText;

    }

  }

</script>

<html>
<head>
   <title>HtmlTableRowCollection Example</title>
</head>
<body>

   <form runat="server">

      <h3>HtmlTableRowCollection Example</h3>

      <table id="Table1" 
             border="1" 
             bordercolor="black" 
             runat="server">

         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
         </tr>
         <tr>
            <td>
               Cell 3
            </td>
            <td>
               Cell 4
            </td>
         </tr>

      </table>


      <br><br>
  
      <input type="button" 
             value="Display row contents in the table"
             onserverclick="Button_Click" 
             runat="server"/>

      <br><br>

      <span id="Span1"
            runat="server"/>

   </form>

</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>

<script runat="server">

  function Button_Click(sender, e : EventArgs) 
  {
 
    var current_row : HtmlTableRow;

    // Create an IEnumerator enumerator.
    var myEnum : IEnumerator = Table1.Rows.GetEnumerator();      

    Span1.InnerText = "The items in the rows of the table are: ";

    // Iterate through the IEnumerator and display its contents.
    while (myEnum.MoveNext()) 
    {
         
      current_row = HtmlTableRow(myEnum.Current);
      Span1.InnerText = Span1.InnerText + " " + current_row.Cells[0].InnerText +
                        " " + current_row.Cells[1].InnerText;

    }

  }

</script>

<html>
<head>
   <title>HtmlTableRowCollection Example</title>
</head>
<body>

   <form runat="server">

      <h3>HtmlTableRowCollection Example</h3>

      <table id="Table1" 
             border="1" 
             bordercolor="black" 
             runat="server">

         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
         </tr>
         <tr>
            <td>
               Cell 3
            </td>
            <td>
               Cell 4
            </td>
         </tr>

      </table>


      <br><br>
  
      <input type="button" 
             value="Display row contents in the table"
             onserverclick="Button_Click" 
             runat="server"/>

      <br><br>

      <span id="Span1"
            runat="server"/>

   </form>

</body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlTableRowCollection-Klasse
HtmlTableRowCollection-Member
System.Web.UI.HtmlControls-Namespace
System.Collections.IEnumerator
HtmlTableRow-Klasse
IEnumerator.Current
IEnumerator.MoveNext
IEnumerator.Reset