XmlReader.MoveToAttribute 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

在衍生類別中覆寫時，移至指定的屬性。

多載

MoveToAttribute(Int32)	在衍生類別中覆寫時，移至具有指定索引的屬性。
MoveToAttribute(String)	在衍生類別中覆寫時，移至具有指定 Name 的屬性。
MoveToAttribute(String, String)	在衍生類別中覆寫時，移至具有指定 LocalName 和 NamespaceURI 的屬性。

MoveToAttribute(Int32)

來源:

XmlReader.cs

在衍生類別中覆寫時，移至具有指定索引的屬性。

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)

參數

i

Int32

屬性的索引。

例外狀況

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

ArgumentOutOfRangeException

參數的值是負數。

範例

下列範例會顯示目前節點上的所有屬性。

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)

來源:

XmlReader.cs

在衍生類別中覆寫時，移至具有指定 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

參數

name

String

屬性的限定名稱 (Qualified Name)。

傳回

Boolean

如果找到屬性，則為 true，否則為 false。 如果為 false，則不會變更讀取器的位置。

例外狀況

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

ArgumentException

參數為空字串。

備註

呼叫 MoveToAttribute 之後， Name 、 NamespaceURI 和 Prefix 屬性會反映該屬性的屬性。

MoveToAttribute(String, String)

來源:

XmlReader.cs

在衍生類別中覆寫時，移至具有指定 LocalName 和 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

參數

name

String

屬性的本機名稱。

ns

String

屬性的命名空間 URI。

傳回

Boolean

如果找到屬性，則為 true，否則為 false。 如果為 false，則不會變更讀取器的位置。

例外狀況

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

ArgumentNullException

這兩個參數值為 null。

備註

呼叫 MoveToAttribute 之後， Name 、 NamespaceURI 和 Prefix 屬性會反映該屬性的屬性。