英語で読む 編集

次の方法で共有


XmlReader.MoveToAttribute Method

Definition

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

C#
public virtual void MoveToAttribute(int i);
C#
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.

C#
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 10 およびその他のバージョン
製品 バージョン
.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, 10
.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.

C#
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 10 およびその他のバージョン
製品 バージョン
.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, 10
.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.

C#
public abstract bool MoveToAttribute(string name, string ns);
C#
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 10 およびその他のバージョン
製品 バージョン
.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, 10
.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