XmlReader.GetAttribute 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

在衍生類別中覆寫時，取得屬性值。

多載

GetAttribute(String, String)	在衍生類別中覆寫時，取得具有指定 LocalName 與 NamespaceURI 的屬性值。
GetAttribute(Int32)	在衍生類別中覆寫時，取得具有指定索引的屬性值。
GetAttribute(String)	在衍生類別中覆寫時，取得具有指定 Name 的屬性值。

GetAttribute(String, String)

在衍生類別中覆寫時，取得具有指定 LocalName 與 NamespaceURI 的屬性值。

public:
 abstract System::String ^ GetAttribute(System::String ^ name, System::String ^ namespaceURI);

public abstract string GetAttribute (string name, string namespaceURI);

public abstract string? GetAttribute (string name, string? namespaceURI);

abstract member GetAttribute : string * string -> string

Public MustOverride Function GetAttribute (name As String, namespaceURI As String) As String

參數

name

String

屬性的本機名稱。

namespaceURI

String

屬性的命名空間 URI。

傳回

String

指定的屬性值。 如果找不到該屬性或其值為 String.Empty，則傳回 null。 這個方法不會移動讀取器。

例外狀況

ArgumentNullException

name 為 null。

InvalidOperationException

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

備註

下列 XML 包含特定命名空間中的屬性：

<test xmlns:dt="urn:datatypes" dt:type="int"/>

您可以使用一個引數 (前置詞和區功能變數名稱稱) 或兩個引數來查閱 dt:type 屬性， (本機名稱和命名空間 URI) ：

String dt = reader.GetAttribute("dt:type");
String dt2 = reader.GetAttribute("type","urn:datatypes");

若要查閱 xmlns:dt 屬性，請使用下列其中一個引數：

String dt3 = reader.GetAttribute("xmlns:dt");
String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);

您也可以使用 Prefix 屬性取得這項資訊。

GetAttribute(Int32)

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

public:
 abstract System::String ^ GetAttribute(int i);

public abstract string GetAttribute (int i);

abstract member GetAttribute : int -> string

Public MustOverride Function GetAttribute (i As Integer) As String

參數

i

Int32

屬性的索引。 此索引是以零為起始。 (第一個屬性的索引為 0。)

傳回

String

指定的屬性值。 這個方法不會移動讀取器。

例外狀況

ArgumentOutOfRangeException

i 超出範圍。 它必須是非負值，而且小於屬性集合的大小。

InvalidOperationException

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

範例

下列範例會取得第三個屬性的值。

reader.ReadToFollowing("book");
string isbn = reader.GetAttribute(2);

reader.ReadToFollowing("book")
Dim isbn As String = reader.GetAttribute(2)

GetAttribute(String)

在衍生類別中覆寫時，取得具有指定 Name 的屬性值。

public:
 abstract System::String ^ GetAttribute(System::String ^ name);

public abstract string GetAttribute (string name);

public abstract string? GetAttribute (string name);

abstract member GetAttribute : string -> string

Public MustOverride Function GetAttribute (name As String) As String

參數

name

String

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

傳回

String

指定的屬性值。 如果找不到該屬性或其值為 String.Empty，則傳回 null。

例外狀況

ArgumentNullException

name 為 null。

InvalidOperationException

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

範例

下列範例會取得 ISBN 屬性的值。

reader.ReadToFollowing("book");
string isbn = reader.GetAttribute("ISBN");
Console.WriteLine("The ISBN value: " + isbn);

reader.ReadToFollowing("book")
Dim isbn As String = reader.GetAttribute("ISBN")
Console.WriteLine("The ISBN value: " + isbn)

備註

這個方法不會移動讀取器。

如果讀取器位於 DocumentType 節點上，則這個方法可用來取得 PUBLIC 和 SYSTEM 常值，例如 reader.GetAttribute("PUBLIC")