XmlTextReader.MoveToFirstAttribute Method (System.Xml)

MoveToFirstAttribute Method

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

XmlTextReader..::.MoveToFirstAttribute Method

Moves to the first attribute.

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

Syntax

Visual Basic (Declaration)

Public Overrides Function MoveToFirstAttribute As Boolean

Visual Basic (Usage)

Dim instance As XmlTextReader
Dim returnValue As Boolean

returnValue = instance.MoveToFirstAttribute()

public override bool MoveToFirstAttribute()

Visual C++

public:
virtual bool MoveToFirstAttribute() override

JScript

public override function MoveToFirstAttribute() : boolean

Return Value

Type: System..::.Boolean
true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).

Remarks

Note:
In the .NET Framework version 2.0 release, the recommended practice is to create XmlReader instances using the XmlReader..::.Create method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

Examples

The following example gets the value of the first attribute of the root node.

Visual Basic

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample

   Public Shared Sub Main()
      Dim reader As XmlTextReader = Nothing

      Try
         'Load the reader with the XML file.
         reader = New XmlTextReader("attrs.xml")

         'Read the genre attribute.
         reader.MoveToContent()
         reader.MoveToFirstAttribute()
         Dim genre As String = reader.Value
         Console.WriteLine("The genre value: " & genre)

      Finally
         If Not (reader Is Nothing) Then
            reader.Close()
         End If
      End Try
   End Sub 'Main 
End Class 'Sample

using System;
using System.IO;
using System.Xml;

public class Sample 
{
  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {
       //Load the reader with the XML file.
       reader = new XmlTextReader("attrs.xml");

       //Read the genre attribute.
       reader.MoveToContent();
       reader.MoveToFirstAttribute();
       string genre=reader.Value;
       Console.WriteLine("The genre value: " + genre);

     } 
     finally 
     {
        if (reader != null)
          reader.Close();
      }
  }

} // End class

Visual C++

#using <System.Xml.dll>

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

      //Load the reader with the XML file.
      reader = gcnew XmlTextReader( "attrs.xml" );

      //Read the genre attribute.
      reader->MoveToContent();
      reader->MoveToFirstAttribute();
      String^ genre = reader->Value;
      Console::WriteLine( "The genre value: {0}", genre );
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlTextReader reader = null;

        try {
            //Load the reader with the XML file.
            reader = new XmlTextReader("attrs.xml");

            //Read the genre attribute.
            reader.MoveToContent();
            reader.MoveToFirstAttribute();
            String genre = reader.get_Value();
            Console.WriteLine("The genre value: " + genre);
        } 
        finally {
            if ( reader  != null ) {
                reader.Close();
            }
        }
    } //main
} // End class Sample

The example uses the file, attrs.xml, as input.

<book genre='novel' ISBN='1-861003-78' pubdate='1987'>
</book>

Platforms

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information