XmlReader.GetAttribute Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

En cas de substitution dans une classe dérivée, obtient la valeur d'un attribut.

Surcharges

GetAttribute(String, String)	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le LocalName et le NamespaceURI spécifiés.
GetAttribute(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec l'index spécifié.
GetAttribute(String)	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le Name spécifié.

GetAttribute(String, String)

En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le LocalName et le NamespaceURI spécifiés.

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

Paramètres

name

String

Le nom local de l'attribut.

namespaceURI

String

L'URI de l'espace de noms de l'attribut.

Retours

String

Valeur de l'attribut spécifié. Si l'attribut est introuvable ou si la valeur est String.Empty, null est retourné. Cette méthode ne déplace pas le lecteur.

Exceptions

ArgumentNullException

name a la valeur null.

InvalidOperationException

Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Le code XML suivant contient un attribut dans un espace de noms spécifique :

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

Vous pouvez rechercher l’attribut à l’aide dt:type d’un argument (préfixe et nom local) ou de deux arguments (nom local et URI d’espace de noms) :

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

Pour rechercher l’attribut xmlns:dt , utilisez l’un des arguments suivants :

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

Vous pouvez également obtenir ces informations à l’aide de la Prefix propriété.

GetAttribute(Int32)

En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec l'index spécifié.

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

Paramètres

i

Int32

Index de l'attribut. L'index est de base zéro. Le premier attribut possède l'index 0.

Retours

String

Valeur de l'attribut spécifié. Cette méthode ne déplace pas le lecteur.

Exceptions

ArgumentOutOfRangeException

i est hors limites. Il doit être non négatif et inférieur à la taille de la collection d'attributs.

InvalidOperationException

Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant obtient la valeur du troisième attribut.

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

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

GetAttribute(String)

En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le Name spécifié.

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

Paramètres

name

String

Nom qualifié de l'attribut.

Retours

String

Valeur de l'attribut spécifié. Si l'attribut est introuvable ou si la valeur est String.Empty, null est retourné.

Exceptions

ArgumentNullException

name a la valeur null.

InvalidOperationException

Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant obtient la valeur de l’attribut 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)

Remarques

Cette méthode ne déplace pas le lecteur.

Si le lecteur est positionné sur un DocumentType nœud, cette méthode peut être utilisée pour obtenir les littéraux PUBLIC et SYSTEM, par exemple, reader.GetAttribute("PUBLIC")