XmlReader.MoveToAttribute Method

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

When overridden in a derived class, moves to the specified attribute.

Overloads

MoveToAttribute(Int32)	When overridden in a derived class, moves to the attribute with the specified index.
MoveToAttribute(String)	When overridden in a derived class, moves to the attribute with the specified Name.
MoveToAttribute(String, String)	When overridden in a derived class, moves to the attribute with the specified LocalName and NamespaceURI.

MoveToAttribute(Int32)

Source:

XmlReader.cs

When overridden in a derived class, moves to the attribute with the specified index.

public:
 virtual void MoveToAttribute(int i);

public virtual void MoveToAttribute (int i);

abstract member MoveToAttribute : int -> unit
override this.MoveToAttribute : int -> unit

Public Overridable Sub MoveToAttribute (i As Integer)

Parameters

i

Int32

The index of the attribute.

Exceptions

InvalidOperationException

An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

ArgumentOutOfRangeException

The parameter has a negative value.

Examples

The following example displays all attributes on the current node.

if (reader.HasAttributes) {
  Console.WriteLine("Attributes of <" + reader.Name + ">");
  for (int i = 0; i < reader.AttributeCount; i++) {
    reader.MoveToAttribute(i);
    Console.Write(" {0}={1}", reader.Name, reader.Value);
  }
reader.MoveToElement(); // Moves the reader back to the element node.
}

If reader.HasAttributes Then
  Console.WriteLine("Attributes of <" + reader.Name + ">")
  Dim i As Integer
  For i = 0 To reader.AttributeCount - 1
    reader.MoveToAttribute(i)
    Console.Write(" {0}={1}", reader.Name, reader.Value)
  Next i
  reader.MoveToElement() 'Moves the reader back to the element node.
End If

MoveToAttribute(String)

Source:

XmlReader.cs

When overridden in a derived class, moves to the attribute with the specified Name.

public:
 abstract bool MoveToAttribute(System::String ^ name);

public abstract bool MoveToAttribute (string name);

abstract member MoveToAttribute : string -> bool

Public MustOverride Function MoveToAttribute (name As String) As Boolean

Parameters

name

String

The qualified name of the attribute.

Returns

Boolean

true if the attribute is found; otherwise, false. If false, the reader's position does not change.

Exceptions

InvalidOperationException

An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

ArgumentException

The parameter is an empty string.

Remarks

After calling MoveToAttribute, the Name, NamespaceURI, and Prefix properties reflect the properties of that attribute.

MoveToAttribute(String, String)

Source:

XmlReader.cs

When overridden in a derived class, moves to the attribute with the specified LocalName and NamespaceURI.

public:
 abstract bool MoveToAttribute(System::String ^ name, System::String ^ ns);

public abstract bool MoveToAttribute (string name, string? ns);

abstract member MoveToAttribute : string * string -> bool

Public MustOverride Function MoveToAttribute (name As String, ns As String) As Boolean

Parameters

name

String

The local name of the attribute.

ns

String

The namespace URI of the attribute.

Returns

Boolean

true if the attribute is found; otherwise, false. If false, the reader's position does not change.

Exceptions

InvalidOperationException

An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

ArgumentNullException

Both parameter values are null.

Remarks

After calling MoveToAttribute, the Name, NamespaceURI, and Prefix properties reflect the properties of that attribute.