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

属性的限定名称。

返回

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