Freigeben über


HtmlTableCellCollection.GetEnumerator-Methode

Gibt ein implementiertes System.Collections.IEnumerator-Objekt zurück, das alle HtmlTableCell-Objekte in der HtmlTableCellCollection-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 HtmlTableCellCollection
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 HtmlTableCell-Objekte in der HtmlTableCellCollection enthält.

Hinweise

Erstellen Sie mit dieser Methode ein implementiertes System.Collections.IEnumerator-Objekt, das durchlaufen werden kann, um den Inhalt jedes Elements in der HtmlTableCellCollection-Auflistung abzurufen.

Mit der IEnumerator.Current-Eigenschaft können Sie das Element der Auflistung abrufen, auf das momentan gezeigt wird.

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

Die IEnumerator.MoveNext-Methode muss aufgerufen werden, nachdem das implementierte 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 implementiertes System.Collections.IEnumerator-Objekt erstellt wird. Anschließend wird das Objekt durchlaufen, um den Inhalt der HtmlTableCellCollection-Auflistung anzuzeigen.

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

<script runat="server">
  
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
 
    Dim current_cell As HtmlTableCell

    ' Create an IEnumerator instance.
    Dim myEnum As IEnumerator = Table1.Rows(0).Cells.GetEnumerator()

    Span1.InnerText = "The items in the first row are: "

    ' Iterate through the IEnumerator and display its contents.
    While myEnum.MoveNext()
         
      current_cell = CType(myEnum.Current, HtmlTableCell)
      Span1.InnerText = Span1.InnerText & " " & current_cell.InnerText

    End While

  End Sub

</script>

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

   <form runat="server">

      <h3>HtmlTableCellCollection 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 the contents of the first row"
             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)
  {

    HtmlTableCell current_cell;

    // Create an IEnumerator instance.
    IEnumerator myEnum = Table1.Rows[0].Cells.GetEnumerator();

    Span1.InnerText = "The items in the first row are: ";

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

      current_cell = (HtmlTableCell)myEnum.Current;
      Span1.InnerText = Span1.InnerText + " " + current_cell.InnerText;

    }

  }

</script>

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

   <form runat="server">

      <h3>HtmlTableCellCollection 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 the contents of the first row"
             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_cell : HtmlTableCell;

     // Create an IEnumerator instance.
     var myEnum : IEnumerator = Table1.Rows[0].Cells.GetEnumerator();      

     Span1.InnerText = "The items in the first row are: ";

     // Iterate through the IEnumerator and display its contents.
     while (myEnum.MoveNext()) 
     {
         
        current_cell = HtmlTableCell(myEnum.Current);
        Span1.InnerText = Span1.InnerText + " " + current_cell.InnerText;

     }

  }

</script>

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

   <form runat="server">

      <h3>HtmlTableCellCollection 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 the contents of the first row"
             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

HtmlTableCellCollection-Klasse
HtmlTableCellCollection-Member
System.Web.UI.HtmlControls-Namespace
System.Collections.IEnumerator
HtmlTableCell-Klasse
IEnumerator.Current
IEnumerator.MoveNext
IEnumerator.Reset