This documentation is archived and is not being maintained.

XmlNode.GetEnumerator Method

Provides support for the for each style iteration over the nodes in the XmlNode.

[Visual Basic]
Public Function GetEnumerator() As IEnumerator
public IEnumerator GetEnumerator();
public: IEnumerator* GetEnumerator();
public function GetEnumerator() : IEnumerator;

Return Value

An IEnumerator.


This method is a Microsoft extension to the Document Object Model (DOM).


[Visual Basic, C#, C++] The following example displays all the books in the XML document.

[Visual Basic] 
Imports System
Imports System.Collections
Imports System.Xml

public class Sample

  public shared sub Main()
    Dim doc as XmlDocument = new XmlDocument()

    Console.WriteLine("Display all the books...")
    Dim root as XmlNode = doc.DocumentElement
    Dim ienum as IEnumerator = root.GetEnumerator()
    Dim book as XmlNode
    while (ienum.MoveNext())      
      book = CType(ienum.Current, XmlNode)
    end while

  end sub
end class

using System;
using System.Collections;
using System.Xml;

public class Sample {

  public static void Main() {
    XmlDocument doc = new XmlDocument();

    Console.WriteLine("Display all the books...");
    XmlNode root = doc.DocumentElement;
    IEnumerator ienum = root.GetEnumerator();
    XmlNode book;
    while (ienum.MoveNext()) 
      book = (XmlNode) ienum.Current;


#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Collections;
using namespace System::Xml;

int main()
    XmlDocument* doc = new XmlDocument();

    Console::WriteLine(S"Display all the books...");
    XmlNode* root = doc->DocumentElement;
    IEnumerator* ienum = root->GetEnumerator();
    XmlNode* book;
    while (ienum->MoveNext()) 
      book = dynamic_cast<XmlNode*> (ienum->Current);

[Visual Basic, C#, C++] The example uses the file, books.xml, as input.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

XmlNode Class | XmlNode Members | System.Xml Namespace