XmlNodeReader::Skip Method ()

 

Skips the children of the current node.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public:
virtual void Skip() override

System_CAPS_noteNote

In the .NET Framework 2.0, the recommended practice is to create XmlReader instances using the XmlReaderSettings class and the Create method. This allows you to take full advantage of all the new features introduced in the .NET Framework. For more information, see the Remarks section in the XmlReader reference page.

For example, suppose you have the following XML input:

<a name="bob" age="123">
   <x/>abc<y/>
 </a>
 <b>
...
 </b>

If the reader is positioned on the "<a>" node or any of its attributes, calling Skip positions the reader to the "<b>" node.

If the reader is positioned on a leaf node already (such as element "x" or the text node "abc"), calling Skip is the same as calling Read.

This method checks for well-formed XML.

The following example reads the price element node in the XML document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlNodeReader^ reader = nullptr;
   try
   {

      //Create and load the XML document.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<!-- sample XML -->"
      "<book>"
      "<title>Pride And Prejudice</title>"
      "<price>19.95</price>"
      "</book>" );

      //Load the XmlNodeReader 
      reader = gcnew XmlNodeReader( doc );
      reader->MoveToContent(); //Move to the book node.
      reader->Read(); //Read the book start tag.
      reader->Skip(); //Skip the title element.
      Console::WriteLine( reader->ReadOuterXml() ); //Read the price element.
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

.NET Framework
Available since 1.1
Return to top
Show: