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이 throw됩니다.

설명

다음 XML에는 특정 네임스페이스의 특성이 포함되어 있습니다.

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

하나의 인수(접두사 및 로컬 이름) 또는 두 개의 인수(로컬 이름 및 네임스페이스 URI)를 사용하여 특성을 조회 dt:type 할 수 있습니다.

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부터 시작합니다. 첫 번째 특성의 인덱스는 0입니다.

반환

String

지정된 특성의 값을 반환합니다. 이 메서드는 판독기를 이동하지 않습니다.

예외

ArgumentOutOfRangeException

i이 범위에서 벗어난 경우. 음수가 아니어야 하며 특성 컬렉션의 크기보다 작아야합니다.

InvalidOperationException

이전 비동기 작업이 완료되기 전에 XmlReader 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

예제

다음 예제에서는 세 번째 특성의 값을 가져옵니다.

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이 throw됩니다.

예제

다음 예제에서는 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")