XmlReader.GetAttribute Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Türetilmiş bir sınıfta geçersiz kılındığında, özniteliğin değerini alır.

Aşırı Yüklemeler

GetAttribute(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIile özniteliğinin değerini alır.
GetAttribute(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizine sahip özniteliğin değerini alır.
GetAttribute(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğinin değerini alır.

GetAttribute(String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIile özniteliğinin değerini alır.

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

Parametreler

name

String

Özniteliğin yerel adı.

namespaceURI

String

Özniteliğin ad alanı URI'si.

Döndürülenler

String

Belirtilen özniteliğin değeri. Öznitelik bulunamazsa veya değeri ise String.Emptynull döndürülür. Bu yöntem okuyucuyu taşımaz.

Özel durumlar

ArgumentNullException

name, null değeridir.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Aşağıdaki XML, belirli bir ad alanında bir öznitelik içerir:

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

Özniteliği aramak dt:type için bir bağımsız değişken (ön ek ve yerel ad) veya iki bağımsız değişken (yerel ad ve ad alanı URI'si) kullanabilirsiniz:

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

Özniteliğini bulmak xmlns:dt için aşağıdaki bağımsız değişkenlerden birini kullanın:

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

Bu bilgileri özelliğini kullanarak Prefix da alabilirsiniz.

GetAttribute(Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizine sahip özniteliğin değerini alır.

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

Parametreler

i

Int32

özniteliğinin dizini. Dizin sıfır tabanlıdır. (İlk öznitelik 0 dizinine sahiptir.)

Döndürülenler

String

Belirtilen özniteliğin değeri. Bu yöntem okuyucuyu taşımaz.

Özel durumlar

ArgumentOutOfRangeException

i aralığın dışında. Negatif olmayan ve öznitelik koleksiyonunun boyutundan küçük olmalıdır.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek üçüncü özniteliğin değerini alır.

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

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

GetAttribute(String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğinin değerini alır.

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

Parametreler

name

String

Özniteliğin tam adı.

Döndürülenler

String

Belirtilen özniteliğin değeri. Öznitelik bulunamazsa veya değeri ise String.Emptynull döndürülür.

Özel durumlar

ArgumentNullException

name, null değeridir.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek ISBN özniteliğinin değerini alır.

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)

Açıklamalar

Bu yöntem okuyucuyu taşımaz.

Okuyucu bir DocumentType düğüme konumlandırıldıysa, bu yöntem PUBLIC ve SYSTEM değişmez değerlerini almak için kullanılabilir, örneğin, reader.GetAttribute("PUBLIC")