Classe System::Xml::XmlTextReader

XmlTextReader class

Représente un lecteur qui fournit un accès rapide, non mis en cache, en avant uniquement aux données XML.

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

Méthodes

MéthodeDescription
Close() overrideModifie le XmlReader::get_ReadState en Closed.
get_AttributeCount() overrideRenvoie le nombre d’attributs du nœud actuel.
get_BaseURI() overrideRenvoie l’URI de base du nœud actuel.
get_CanReadBinaryContent() overrideRenvoie une valeur indiquant si le XmlTextReader implémente les méthodes de lecture de contenu binaire.
get_CanReadValueChunk() overrideRenvoie une valeur indiquant si le XmlTextReader implémente la méthode XmlReader::ReadValueChunk.
get_CanResolveEntity() overrideRenvoie une valeur indiquant si ce lecteur peut analyser et résoudre les entités.
get_Depth() overrideRenvoie la profondeur du nœud actuel dans le document XML.
get_DtdProcessing()Renvoie l’énumération DtdProcessing.
get_Encoding()Renvoie le codage du document.
get_EntityHandling()Renvoie une valeur qui spécifie comment le lecteur gère les entités.
get_EOF() overrideRenvoie une valeur indiquant si le lecteur est positionné à la fin du flux.
get_HasValue() overrideRenvoie une valeur indiquant si le nœud actuel peut avoir un XmlTextReader::get_Value différent de String::Empty.
get_IsDefault() overrideRenvoie une valeur indiquant si le nœud actuel est un attribut généré à partir de la valeur par défaut définie dans le DTD ou le schéma.
get_IsEmptyElement() overrideRenvoie une valeur indiquant si le nœud actuel est un élément vide (par exemple, ).
get_LineNumber() overrideRenvoie le numéro de ligne actuel.
get_LinePosition() overrideRenvoie la position de ligne actuelle.
get_LocalName() overrideRenvoie le nom local du nœud actuel.
get_Name() overrideRenvoie le nom qualifié du nœud actuel.
get_Namespaces()Renvoie une valeur indiquant s’il faut activer la prise en charge des espaces de noms.
get_NamespaceURI() overrideRenvoie l’URI de l’espace de noms (tel que défini dans la spécification W3C Namespace) du nœud sur lequel le lecteur est positionné.
get_NameTable() overrideRenvoie le XmlNameTable associé à cette implémentation.
get_NodeType() overrideRenvoie le type du nœud actuel.
get_Normalization()Renvoie une valeur indiquant s’il faut normaliser les espaces blancs et les valeurs d’attribut.
get_Prefix() overrideRenvoie le préfixe d’espace de noms associé au nœud actuel.
get_ProhibitDtd()Renvoie une valeur indiquant s’il faut autoriser le traitement du DTD.
get_QuoteChar() overrideRenvoie le caractère de guillemet utilisé pour entourer la valeur d’un nœud d’attribut.
get_ReadState() overrideRenvoie l’état du lecteur.
get_Value() overrideRenvoie la valeur texte du nœud actuel.
get_WhitespaceHandling()Renvoie une valeur qui spécifie comment les espaces blancs sont gérés.
get_XmlLang() overrideRenvoie la portée actuelle de xml:lang.
get_XmlSpace() overrideRenvoie la portée actuelle de xml:space.
GetAttribute(String) overrideRenvoie la valeur de l’attribut avec le nom spécifié.
GetAttribute(String, String) overrideRenvoie la valeur de l’attribut avec le nom local et l’URI d’espace de noms spécifiés.
GetAttribute(int32_t) overrideRenvoie la valeur de l’attribut avec l’index spécifié.
GetNamespacesInScope(XmlNamespaceScope) overrideRenvoie une collection qui contient tous les espaces de noms actuellement en portée.
GetRemainder()Renvoie le reste du XML mis en mémoire tampon.
HasLineInfo() overrideRenvoie une valeur indiquant si la classe peut renvoyer des informations de ligne.
LookupNamespace(const String&) overrideRésout un préfixe d’espace de noms dans la portée de l’élément actuel.
MoveToAttribute(String) overrideSe déplace vers l’attribut avec le nom spécifié.
MoveToAttribute(String, String) overrideSe déplace vers l’attribut avec le nom local et l’URI d’espace de noms spécifiés.
MoveToAttribute(int32_t) overrideSe déplace vers l’attribut avec l’index spécifié.
MoveToElement() overrideSe déplace vers l’élément qui contient le nœud d’attribut actuel.
MoveToFirstAttribute() overrideSe déplace vers le premier attribut.
MoveToNextAttribute() overrideSe déplace vers l’attribut suivant.
Read() overrideLit le nœud suivant du flux.
ReadAttributeValue() overrideAnalyse la valeur de l’attribut en un ou plusieurs nœuds Text, EntityReference, ou EndEntity.
ReadBase64(const ArrayPtr<uint8_t>&, int32_t, int32_t)Décode Base64 et renvoie les octets binaires décodés.
ReadBinHex(const ArrayPtr<uint8_t>&, int32_t, int32_t)Décode BinHex et renvoie les octets binaires décodés.
ReadChars(const ArrayPtr<char16_t>&, int32_t, int32_t)Lit le contenu texte d’un élément dans un tampon de caractères. Cette méthode est conçue pour lire de grands flux de texte intégré en l’appelant successivement.
ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLit le contenu et renvoie les octets binaires décodés Base64.
ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLit le contenu et renvoie les octets binaires décodés BinHex.
ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLit l’élément et décode le contenu Base64.
ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLit l’élément et décode le contenu BinHex.
ReadString() overrideLit le contenu d’un élément ou d’un nœud texte sous forme de chaîne.
ResetState()Réinitialise l’état du lecteur à ReadState::Initial.
ResolveEntity() overrideRésout la référence d’entité pour les nœuds EntityReference.
set_DtdProcessing(System::Xml::DtdProcessing)Définit l’énumération DtdProcessing.
set_EntityHandling(System::Xml::EntityHandling)Définit une valeur qui spécifie comment le lecteur gère les entités.
set_Namespaces(bool)Définit une valeur indiquant s’il faut activer la prise en charge des espaces de noms.
set_Normalization(bool)Définit une valeur indiquant s’il faut normaliser les espaces blancs et les valeurs d’attribut.
set_ProhibitDtd(bool)Définit une valeur indiquant s’il faut autoriser le traitement DTD.
set_WhitespaceHandling(System::Xml::WhitespaceHandling)Définit une valeur qui spécifie comment les espaces blancs sont gérés.
set_XmlResolver(const SharedPtr<System::Xml::XmlResolver>&)Définit le XmlResolver utilisé pour résoudre les références DTD.
Skip() overrideIgnore les enfants du nœud actuel.
XmlTextReader(const SharedPtr<IO::Stream>&)Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&)Initialise une nouvelle instance de la classe XmlTextReader avec l’URL et le flux spécifiés.
XmlTextReader(const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié et le XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)Initialise une nouvelle instance de la classe XmlTextReader avec l’URL, le flux et le XmlNameTable spécifiés.
XmlTextReader(const SharedPtr<IO::TextReader>&)Initialise une nouvelle instance de la classe XmlTextReader avec le TextReader spécifié.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&)Initialise une nouvelle instance de la classe XmlTextReader avec l’URL et le TextReader spécifiés.
XmlTextReader(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)Initialise une nouvelle instance de la classe XmlTextReader avec le TextReader spécifié et le XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)Initialise une nouvelle instance de la classe XmlTextReader avec l’URL, le TextReader et le XmlNameTable spécifiés.
XmlTextReader(const SharedPtr<IO::Stream>&, XmlNodeType, const SharedPtr<XmlParserContext>&)Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié, XmlNodeType, et XmlParserContext.
XmlTextReader(const String&, XmlNodeType, const SharedPtr<XmlParserContext>&)Initialise une nouvelle instance de la classe XmlTextReader avec la chaîne spécifiée, XmlNodeType, et XmlParserContext.
XmlTextReader(const String&)Initialise une nouvelle instance de la classe XmlTextReader avec le fichier spécifié.
XmlTextReader(const String&, const SharedPtr<XmlNameTable>&)Initialise une nouvelle instance de la classe XmlTextReader avec le fichier spécifié et XmlNameTable.

Typedefs

TypedefDescription
PtrUn alias pour un pointeur partagé vers une instance de cette classe.

Remarques

Il est recommandé d’utiliser la classe XmlReader à la place.

Les objets de cette classe ne doivent être alloués qu’en utilisant la fonction System::MakeObject(). Ne créez jamais d’instances de ce type sur la pile ou en utilisant l’opérateur new, car cela entraînera des erreurs d’exécution et/ou des échecs d’assertion. Enveloppez toujours cette classe dans un pointeur System::SmartPtr et utilisez ce pointeur pour le passer aux fonctions en tant qu’argument.

Voir aussi