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)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

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

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

Applies to

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

MoveToAttribute(String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

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

public abstract bool MoveToAttribute (string name);

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

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

MoveToAttribute(String, String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

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

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

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

.NET 9 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0