XmlReader.MoveToAttribute Method

Definition

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)

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

public:
 virtual void MoveToAttribute(int i);
public:
 abstract void MoveToAttribute(int i);
public virtual void MoveToAttribute (int i);
public abstract void MoveToAttribute (int i);
abstract member MoveToAttribute : int -> unit
override this.MoveToAttribute : int -> unit
abstract member MoveToAttribute : int -> unit
Public Overridable Sub MoveToAttribute (i As Integer)
Public MustOverride Sub MoveToAttribute (i As Integer)

Parameters

i
Int32

The index of the attribute.

Exceptions

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."

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

Applies to

MoveToAttribute(String)

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

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

Exceptions

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."

The parameter is an empty string.

Remarks

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

Applies to

MoveToAttribute(String, String)

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);
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

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

Exceptions

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."

Both parameter values are null.

Remarks

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

Applies to