XmlTextReader Classe

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Représente un lecteur fournissant un accès rapide, non mis en cache et en avant uniquement vers les données XML.

À compter de .NET Framework 2.0, nous vous recommandons d'utiliser plutôt la classe XmlReader.

public ref class XmlTextReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo, System::Xml::IXmlNamespaceResolver

public class XmlTextReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

Héritage

Object

XmlReader

XmlTextReader

Implémente

IXmlLineInfo IXmlNamespaceResolver

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour XmlTextReader.

Notes pour les héritiers

Cette classe a une demande d’héritage. Une confiance totale est requise pour hériter de XmlTextReader.

Constructeurs

XmlTextReader()	Initialise une nouvelle instance de l'objet XmlTextReader.
XmlTextReader(Stream)	Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié.
XmlTextReader(Stream, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié et XmlNameTable.
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié, XmlNodeType et XmlParserContext.
XmlTextReader(String)	Initialise une nouvelle instance de la classe XmlTextReader avec le fichier spécifié.
XmlTextReader(String, Stream)	Initialise une nouvelle instance de la classe XmlTextReader avec l'URL et le flux spécifiés.
XmlTextReader(String, Stream, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec l'URL, le flux et le XmlNameTable spécifiés.
XmlTextReader(String, TextReader)	Initialise une nouvelle instance de la classe XmlTextReader avec l'URL et le TextReader spécifiés.
XmlTextReader(String, TextReader, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec l'URL, le TextReader et le XmlNameTable spécifiés.
XmlTextReader(String, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec le fichier et le XmlNameTable spécifiés.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Initialise une nouvelle instance de la classe XmlTextReader avec la chaîne, le XmlNodeType et le XmlParserContext spécifiés.
XmlTextReader(TextReader)	Initialise une nouvelle instance de la classe XmlTextReader avec le TextReader spécifié.
XmlTextReader(TextReader, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec les TextReader et XmlNameTable spécifiés.
XmlTextReader(XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec le XmlNameTable spécifié.

Propriétés

AttributeCount	Obtient le nombre d'attributs du nœud actuel.
BaseURI	Obtient l'URI de base du nœud actuel.
CanReadBinaryContent	Obtient une valeur indiquant si XmlTextReader implémente les méthodes de lecture de contenu binaire.
CanReadValueChunk	Obtient une valeur indiquant si XmlTextReader implémente la méthode ReadValueChunk(Char[], Int32, Int32).
CanResolveEntity	Obtient une valeur indiquant si ce lecteur peut analyser et résoudre les entités.
Depth	Obtient la profondeur du nœud actuel dans le document XML.
DtdProcessing	Obtient ou définit l'énumération DtdProcessing.
Encoding	Obtient l'encodage du document.
EntityHandling	Obtient ou définit une valeur qui spécifie le mode de gestion des entités par le lecteur.
EOF	Obtient une valeur indiquant si le lecteur est placé à la fin du flux.
HasAttributes	Obtient une valeur indiquant si le nœud actuel a des attributs. (Hérité de XmlReader)
HasValue	Obtient une valeur indiquant si le nœud actuel peut avoir une valeur Value autre que String.Empty.
IsDefault	Obtient une valeur indiquant si le nœud actuel est un attribut qui a été généré à partir de la valeur par défaut définie dans la DTD ou le schéma.
IsEmptyElement	Obtient une valeur indiquant si le nœud actuel est un élément vide (par exemple, <MyElement/>).
Item[Int32]	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec l'index spécifié. (Hérité de XmlReader)
Item[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. (Hérité de XmlReader)
Item[String]	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le Name spécifié. (Hérité de XmlReader)
LineNumber	Obtient le numéro de la ligne active.
LinePosition	Obtient la position de la ligne active.
LocalName	Obtient le nom local du nœud actuel.
Name	Obtient le nom qualifié du nœud actuel.
Namespaces	Obtient ou définit une valeur indiquant si la prise en charge des espaces de noms doit être assurée ou non.
NamespaceURI	Obtient l'URI d'espace de noms (tel qu'il est défini dans la spécification relative aux espaces de noms du W3C) du nœud sur lequel le lecteur est placé.
NameTable	Obtient l'élément XmlNameTable associé à cette implémentation.
NodeType	Obtient le type du nœud actuel.
Normalization	Obtient ou définit une valeur indiquant si les valeurs d'espaces blancs et d'attributs doivent être normalisées.
Prefix	Obtient le préfixe de l'espace de noms associé au nœud actuel.
ProhibitDtd	Obsolète. Obtient ou définit une valeur indiquant si le traitement DTD doit être autorisé. Cette propriété est obsolète. Utilisez plutôt DtdProcessing.
QuoteChar	Obtient le caractère guillemet permettant de délimiter la valeur d'un nœud d'attribut.
ReadState	Obtient l'état du lecteur.
SchemaInfo	Obtient les informations de schéma qui ont été assignées au nœud actuel à la suite de la validation du schéma. (Hérité de XmlReader)
Settings	Obtient l'objet XmlReaderSettings permettant de créer cette instance de XmlReader. (Hérité de XmlReader)
Value	Obtient le texte du nœud actuel.
ValueType	Obtient le type de CLR du nœud actuel. (Hérité de XmlReader)
WhitespaceHandling	Obtient ou définit une valeur qui spécifie le mode de gestion de l'espace blanc.
XmlLang	Obtient la portée de xml:lang actuelle.
XmlResolver	Définit le XmlResolver utilisé pour la résolution des références DTD.
XmlSpace	Obtient la portée de xml:space actuelle.

Méthodes

Close()	Modifie ReadState en lui attribuant la valeur Closed.
Dispose()	Libère toutes les ressources utilisées par l'instance actuelle de la classe XmlReader. (Hérité de XmlReader)
Dispose(Boolean)	Libère les ressources non managées utilisées par XmlReader et libère éventuellement les ressources managées. (Hérité de XmlReader)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetAttribute(Int32)	Obtient la valeur de l'attribut avec l'index spécifié.
GetAttribute(String)	Obtient la valeur de l'attribut avec le nom spécifié.
GetAttribute(String, String)	Obtient la valeur de l'attribut avec le nom local et l'URI de l'espace de noms spécifiés.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetNamespacesInScope(XmlNamespaceScope)	Obtient une collection qui contient tous les espaces de noms actuellement dans la portée.
GetRemainder()	Obtient le reste du contenu XML mis en mémoire tampon.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValueAsync()	Obtient de façon asynchrone la valeur du nœud actuel. (Hérité de XmlReader)
HasLineInfo()	Obtient une valeur indiquant si la classe peut retourner des informations de ligne.
IsStartElement()	Appelle MoveToContent() et vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide. (Hérité de XmlReader)
IsStartElement(String)	Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si la propriété Name de l'élément trouvé correspond à l'argument spécifié. (Hérité de XmlReader)
IsStartElement(String, String)	Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées. (Hérité de XmlReader)
LookupNamespace(String)	Résout un préfixe de l'espace de noms dans la portée de l'élément actuel.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MoveToAttribute(Int32)	Se déplace vers l'attribut avec l'index spécifié.
MoveToAttribute(String)	Se déplace vers l'attribut avec le nom spécifié.
MoveToAttribute(String, String)	Se déplace vers l'attribut avec le nom local et l'URI d'espace de noms spécifiés.
MoveToContent()	Vérifie si le nœud actuel est un nœud de contenu (texte non constitué d'espaces blancs, CDATA, Element, EndElement, EntityReference ou EndEntity). Si le nœud n'est pas un nœud de contenu, le lecteur avance jusqu'au nœud de contenu suivant ou jusqu'à la fin du fichier. Il ignore les nœuds possédant les types suivants : ProcessingInstruction, DocumentType, Comment, Whitespace ou SignificantWhitespace. (Hérité de XmlReader)
MoveToContentAsync()	Vérifie de façon asynchrone si le nœud actuel est un nœud de contenu. Si le nœud n'est pas un nœud de contenu, le lecteur avance jusqu'au nœud de contenu suivant ou jusqu'à la fin du fichier. (Hérité de XmlReader)
MoveToElement()	Se déplace vers l'élément contenant le nœud d'attribut actuel.
MoveToFirstAttribute()	Effectue un déplacement vers le premier attribut.
MoveToNextAttribute()	Effectue un déplacement vers l'attribut suivant.
Read()	Lit le nœud suivant du flux.
ReadAsync()	Lit de façon asynchrone le nœud suivant à partir du flux de données. (Hérité de XmlReader)
ReadAttributeValue()	Analyse la valeur d'attribut selon un ou plusieurs nœuds Text, EntityReference ou EndEntity.
ReadBase64(Byte[], Int32, Int32)	Décode Base64 et retourne les octets binaires décodés.
ReadBinHex(Byte[], Int32, Int32)	Décode BinHex et retourne les octets binaires décodés.
ReadChars(Char[], Int32, Int32)	Lit le texte d'un élément dans une mémoire tampon de caractères. Cette méthode est conçue pour lire des flux importants de texte incorporé en l'appelant de manière successive.
ReadContentAs(Type, IXmlNamespaceResolver)	Lit le contenu en tant qu'objet du type spécifié. (Hérité de XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Lit de façon asynchrone le contenu en tant qu'objet du type spécifié. (Hérité de XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Lit le contenu et retourne les octets binaires décodés au format Base64.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Lit de façon asynchrone le contenu et retourne les octets binaires décodés au format Base64. (Hérité de XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Lit le contenu et retourne les octets binaires décodés au format BinHex.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Lit de façon asynchrone le contenu et retourne les octets binaires décodés au format BinHex. (Hérité de XmlReader)
ReadContentAsBoolean()	Lit le contenu de texte à la position actuelle comme un Boolean. (Hérité de XmlReader)
ReadContentAsDateTime()	Lit le contenu de texte à la position actuelle comme un objet DateTime. (Hérité de XmlReader)
ReadContentAsDateTimeOffset()	Lit le contenu de texte à la position actuelle comme un objet DateTimeOffset. (Hérité de XmlReader)
ReadContentAsDecimal()	Lit le contenu de texte à la position actuelle comme un objet Decimal. (Hérité de XmlReader)
ReadContentAsDouble()	Lit le contenu de texte à la position actuelle en tant que nombre à virgule flottante double précision. (Hérité de XmlReader)
ReadContentAsFloat()	Lit le contenu de texte à la position actuelle en tant que nombre à virgule flottante simple précision. (Hérité de XmlReader)
ReadContentAsInt()	Lit le contenu de texte à la position actuelle comme un entier signé de 32 bits. (Hérité de XmlReader)
ReadContentAsLong()	Lit le contenu de texte à la position actuelle comme un entier signé de 64 bits. (Hérité de XmlReader)
ReadContentAsObject()	Lit le contenu de texte à la position actuelle comme un Object. (Hérité de XmlReader)
ReadContentAsObjectAsync()	Lit de façon asynchrone le contenu de texte à la position actuelle comme un objet Object. (Hérité de XmlReader)
ReadContentAsString()	Lit le contenu de texte à la position actuelle comme un objet String. (Hérité de XmlReader)
ReadContentAsStringAsync()	Lit de façon asynchrone le contenu de texte à la position actuelle comme un objet String. (Hérité de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Lit le contenu de l'élément en tant que type demandé. (Hérité de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit le contenu d'élément en tant que type demandé. (Hérité de XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Lit de façon asynchrone le contenu de l'élément en tant que type demandé. (Hérité de XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Lit l'élément et décode le contenu Base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Lit de façon asynchrone l'élément et décode le contenu au format Base64. (Hérité de XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Lit l'élément et décode le contenu au format BinHex.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Lit de façon asynchrone l'élément et décode le contenu au format BinHex. (Hérité de XmlReader)
ReadElementContentAsBoolean()	Lit l'élément actuel et retourne le contenu en tant qu'objet Boolean. (Hérité de XmlReader)
ReadElementContentAsBoolean(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet Boolean. (Hérité de XmlReader)
ReadElementContentAsDateTime()	Lit l'élément actuel et retourne le contenu en tant qu'objet DateTime. (Hérité de XmlReader)
ReadElementContentAsDateTime(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet DateTime. (Hérité de XmlReader)
ReadElementContentAsDecimal()	Lit l'élément actuel et retourne le contenu en tant qu'objet Decimal. (Hérité de XmlReader)
ReadElementContentAsDecimal(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet Decimal. (Hérité de XmlReader)
ReadElementContentAsDouble()	Lit l'élément actuel et retourne le contenu en tant que nombre à virgule flottante double précision. (Hérité de XmlReader)
ReadElementContentAsDouble(String, String)	Vérifie que le nom local et l'URI de l'espace de noms spécifiés correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu sous la forme d'un nombre à virgule flottante double précision. (Hérité de XmlReader)
ReadElementContentAsFloat()	Lit l'élément actuel et retourne le contenu en tant que nombre à virgule flottante simple précision. (Hérité de XmlReader)
ReadElementContentAsFloat(String, String)	Vérifie que le nom local et l'URI de l'espace de noms spécifiés correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu sous la forme d'un nombre à virgule flottante simple précision. (Hérité de XmlReader)
ReadElementContentAsInt()	Lit l'élément actuel et retourne le contenu comme un entier signé de 32 bits. (Hérité de XmlReader)
ReadElementContentAsInt(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'entier signé de 32 bits. (Hérité de XmlReader)
ReadElementContentAsLong()	Lit l’élément actuel et retourne le contenu comme un entier signé de 64 bits. (Hérité de XmlReader)
ReadElementContentAsLong(String, String)	Vérifie que le nom local spécifié et l’URI de l’espace de noms correspondent à ceux de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’entier signé de 64 bits. (Hérité de XmlReader)
ReadElementContentAsObject()	Lit l'élément actuel et retourne le contenu en tant que Object. (Hérité de XmlReader)
ReadElementContentAsObject(String, String)	Vérifie que le nom local et l'URI de l'espace de noms spécifiés correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet Object. (Hérité de XmlReader)
ReadElementContentAsObjectAsync()	Lit de façon asynchrone l'élément actuel et retourne le contenu en tant que Object. (Hérité de XmlReader)
ReadElementContentAsString()	Lit l'élément actuel et retourne le contenu en tant qu'objet String. (Hérité de XmlReader)
ReadElementContentAsString(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet String. (Hérité de XmlReader)
ReadElementContentAsStringAsync()	Lit de façon asynchrone l'élément actuel et retourne le contenu en tant qu'objet String. (Hérité de XmlReader)
ReadElementString()	Lit un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe. (Hérité de XmlReader)
ReadElementString(String)	Vérifie que la propriété Name de l'élément trouvé correspond à la chaîne spécifiée avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe. (Hérité de XmlReader)
ReadElementString(String, String)	Vérifie que les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(String, String), car elle permet de gérer cette opération de façon plus directe. (Hérité de XmlReader)
ReadEndElement()	Vérifie que le nœud de contenu actuel est une étiquette de fin et avance le lecteur jusqu’au nœud suivant. (Hérité de XmlReader)
ReadInnerXml()	En cas de substitution dans une classe dérivée, lit tout le contenu, y compris le balisage, sous forme de chaîne. (Hérité de XmlReader)
ReadInnerXmlAsync()	Lit de façon asynchrone tout le contenu, notamment le balisage, en tant que chaîne. (Hérité de XmlReader)
ReadOuterXml()	En cas de substitution dans une classe dérivée, lit le contenu, y compris le balisage, représentant ce nœud et tous ses enfants. (Hérité de XmlReader)
ReadOuterXmlAsync()	Lit de façon asynchrone le contenu, notamment le balisage, qui représente ce nœud et tous ses enfants. (Hérité de XmlReader)
ReadStartElement()	Vérifie que le nœud actuel est un élément et avance le lecteur jusqu'au nœud suivant. (Hérité de XmlReader)
ReadStartElement(String)	Vérifie que le nœud de contenu actuel est un élément avec le Name spécifié, puis avance le lecteur jusqu'au nœud suivant. (Hérité de XmlReader)
ReadStartElement(String, String)	Vérifie que le nœud de contenu actuel est un élément avec le LocalName et le NamespaceURI spécifiés, puis avance le lecteur jusqu'au nœud suivant. (Hérité de XmlReader)
ReadString()	Lit le contenu d'un nœud d'élément ou de texte sous forme de chaîne.
ReadSubtree()	Retourne une nouvelle instance de XmlReader qui permet de lire le nœud actuel, ainsi que tous ses descendants. (Hérité de XmlReader)
ReadToDescendant(String)	Avance le XmlReader vers l'élément descendant suivant portant le nom qualifié spécifié. (Hérité de XmlReader)
ReadToDescendant(String, String)	Avance XmlReader vers le nœud descendant suivant doté du nom local et de l'URI de l'espace de noms spécifiés. (Hérité de XmlReader)
ReadToFollowing(String)	Lit jusqu'à trouver un élément avec le nom qualifié spécifié. (Hérité de XmlReader)
ReadToFollowing(String, String)	Lit jusqu'à trouver un élément avec le nom local et l'URI de l'espace de noms spécifiés. (Hérité de XmlReader)
ReadToNextSibling(String)	Avance le XmlReader vers l'élément frère suivant portant le nom qualifié spécifié. (Hérité de XmlReader)
ReadToNextSibling(String, String)	Avance XmlReader vers l’élément frère suivant doté du nom local et de l’URI de l’espace de noms spécifiés. (Hérité de XmlReader)
ReadValueChunk(Char[], Int32, Int32)	Lit des flux de texte volumineux incorporés dans un document XML. (Hérité de XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Lit de façon asynchrone des flux de texte volumineux incorporés dans un document XML. (Hérité de XmlReader)
ResetState()	Réinitialise l'état du lecteur à ReadState.Initial.
ResolveEntity()	Résout la référence d'entité pour les nœuds EntityReference.
Skip()	Ignore les enfants du nœud actuel.
SkipAsync()	Ignore de façon asynchrone les enfants du nœud actuel. (Hérité de XmlReader)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Pour obtenir une description de ce membre, consultez GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Pour obtenir une description de ce membre, consultez LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Pour obtenir une description de ce membre, consultez LookupPrefix(String).

Voir aussi

• Documents et données XML