Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XmlReader, classe

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

Espace de noms :  System.Xml
Assembly :  System.Xml (dans System.Xml.dll)

public abstract class XmlReader : IDisposable

Le type XmlReader expose les membres suivants.

  NomDescription
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreXmlReaderInitialise une nouvelle instance de la classe XmlReader.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAttributeCountEn cas de substitution dans une classe dérivée, obtient le nombre d'attributs du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreBaseURIEn cas de substitution dans une classe dérivée, obtient l'URI de base du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCanReadBinaryContentObtient une valeur qui indique si XmlReader implémente les méthodes de lecture de contenu binaire.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCanReadValueChunkObtient une valeur indiquant si XmlReader implémente la méthode ReadValueChunk spécifiée.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCanResolveEntityObtient une valeur indiquant si ce lecteur peut analyser et résoudre les entités.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDepthEn cas de substitution dans une classe dérivée, obtient la profondeur du nœud actuel dans le document XML.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEOFEn cas de substitution dans une classe dérivée, obtient une valeur indiquant si le lecteur est placé à la fin du flux.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreHasAttributesObtient une valeur indiquant si le nœud actuel possède des attributs.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreHasValueEn cas de substitution dans une classe dérivée, obtient une valeur indiquant si le nœud actuel peut posséder Value.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsDefaultEn cas de substitution dans une classe dérivée, obtient 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.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsEmptyElementEn cas de substitution dans une classe dérivée, obtient une valeur indiquant si le nœud actuel est un élément vide (par exemple, <MyElement/>).
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem[Int32]En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec l'index spécifié.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem[String]En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le Name spécifié.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem[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.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLocalNameEn cas de substitution dans une classe dérivée, obtient le nom local du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNameEn cas de substitution dans une classe dérivée, obtient le nom qualifié du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNamespaceURIEn cas de substitution dans une classe dérivée, obtient l'URI de l'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é.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNameTableEn cas de substitution dans une classe dérivée, obtient le XmlNameTable associé à cette implémentation.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNodeTypeEn cas de substitution dans une classe dérivée, obtient le type du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StorePrefixEn cas de substitution dans une classe dérivée, obtient le préfixe de l'espace de noms associé au nœud actuel.
Propriété publiquePris en charge par XNA FrameworkQuoteCharEn cas de substitution dans une classe dérivée, obtient le caractère guillemet permettant de délimiter la valeur d'un nœud d'attribut.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadStateEn cas de substitution dans une classe dérivée, obtient l'état du lecteur.
Propriété publiquePris en charge par XNA FrameworkSchemaInfoObtient les informations de schéma qui ont été assignées au nœud actuel à la suite de la validation du schéma.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSettingsObtient l'objet XmlReaderSettings permettant de créer cette instance de XmlReader.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreValueEn cas de substitution dans une classe dérivée, obtient la valeur texte du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreValueTypeObtient le type de CLR du nœud actuel.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreXmlLangEn cas de substitution dans une classe dérivée, obtient la portée xml:lang en cours.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreXmlSpaceEn cas de substitution dans une classe dérivée, obtient la portée xml:space en cours.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloseEn cas de substitution dans une classe dérivée, modifie ReadState en Closed.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(Stream)Crée une nouvelle instance de XmlReader à l'aide du flux de données spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge dans .NET pour les applications du Windows StoreCreate(String)Crée une instance de XmlReader avec l'URI spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(TextReader)Crée une instance de XmlReader avec le TextReader spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(Stream, XmlReaderSettings)Crée une instance de XmlReader avec le flux et l'objet XmlReaderSettings spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge dans .NET pour les applications du Windows StoreCreate(String, XmlReaderSettings)Crée une instance avec l'URI et les XmlReaderSettings spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(TextReader, XmlReaderSettings)Crée une instance de XmlReader à l'aide des objets TextReader et XmlReaderSettings spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(XmlReader, XmlReaderSettings)Crée une instance de XmlReader avec les objets XmlReader et XmlReaderSettings spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkCreate(Stream, XmlReaderSettings, String)Crée une instance de XmlReader à l'aide du flux, de l'URI de base et de l'objet XmlReaderSettings spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(Stream, XmlReaderSettings, XmlParserContext)Crée une instance de XmlReader à l'aide des objets XmlReaderSettings et XmlParserContext spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkCreate(String, XmlReaderSettings, XmlParserContext)Crée une instance de XmlReader à l'aide de l'URI et des objets XmlReaderSettings et XmlParserContext spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkCreate(TextReader, XmlReaderSettings, String)Crée une instance de XmlReader à l'aide des objets TextReader et de l'URI de base XmlReaderSettings spécifiés.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(TextReader, XmlReaderSettings, XmlParserContext)Crée une instance de XmlReader à l'aide des objets TextReader, XmlReaderSettings et XmlParserContext spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDispose()Libère toutes les ressources utilisées par l'instance actuelle de la classe XmlReader.
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDispose(Boolean)Libère les ressources non managées utilisées par XmlReader et libère éventuellement les ressources managées.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetAttribute(Int32)En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec l'index spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetAttribute(String)En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le Name spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetAttribute(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreGetValueAsyncObtient de façon asynchrone la valeur du nœud actuel.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsNameRetourne une valeur indiquant si l'argument de chaîne est un nom XML valide.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsNameTokenRetourne une valeur indiquant si l'argument de chaîne est un jeton de nom XML valide.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsStartElement()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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsStartElement(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é.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsStartElement(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLookupNamespaceEn cas de substitution dans une classe dérivée, résout un préfixe de l'espace de noms dans la portée de l'élément en cours.
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToAttribute(Int32)En cas de substitution dans une classe dérivée, se déplace vers l'attribut avec l'index spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToAttribute(String)En cas de substitution dans une classe dérivée, se déplace vers l'attribut avec le Name spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToAttribute(String, String)En cas de substitution dans une classe dérivée, se déplace vers l'attribut avec le LocalName et le NamespaceURI spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToContentVé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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreMoveToContentAsyncVé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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToElementEn cas de substitution dans une classe dérivée, se déplace vers l'élément contenant le nœud d'attribut actuel.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToFirstAttributeEn cas de substitution dans une classe dérivée, se déplace vers le premier attribut.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMoveToNextAttributeEn cas de substitution dans une classe dérivée, se déplace vers l'attribut suivant.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadEn cas de substitution dans une classe dérivée, lit le nœud suivant à partir du flux.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadAsyncLit de façon asynchrone le nœud suivant à partir du flux de données.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadAttributeValueEn cas de substitution dans une classe dérivée, analyse la valeur d'attribut dans un ou plusieurs nœuds Text, EntityReference ou EndEntity.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsLit le contenu en tant qu'objet du type spécifié.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadContentAsAsyncLit de façon asynchrone le contenu en tant qu'objet du type spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsBase64Lit le contenu et retourne les octets binaires décodés au format Base64.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadContentAsBase64AsyncLit de façon asynchrone le contenu et retourne les octets binaires décodés au format Base64.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsBinHexLit le contenu et retourne les octets binaires décodés au format BinHex.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadContentAsBinHexAsyncLit de façon asynchrone le contenu et retourne les octets binaires décodés au format BinHex.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsBooleanLit le contenu de texte à la position actuelle comme un Boolean.
Méthode publiquePris en charge par XNA FrameworkReadContentAsDateTimeLit le contenu de texte à la position actuelle comme un objet DateTime.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadContentAsDateTimeOffsetLit le contenu de texte à la position actuelle comme un objet DateTimeOffset.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsDecimalLit le contenu de texte à la position actuelle comme un objet Decimal.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsDoubleLit le contenu de texte à la position actuelle en tant que nombre à virgule flottante double précision.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsFloatLit le contenu de texte à la position actuelle en tant que nombre à virgule flottante simple précision.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsIntLit le contenu de texte à la position actuelle comme un entier signé de 32 bits.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsLongLit le contenu de texte à la position actuelle comme un entier signé de 64 bits.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsObjectLit le contenu de texte à la position actuelle comme un Object.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadContentAsObjectAsyncLit de façon asynchrone le contenu de texte à la position actuelle comme un objet Object.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadContentAsStringLit le contenu de texte à la position actuelle comme un objet String.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadContentAsStringAsyncLit de façon asynchrone le contenu de texte à la position actuelle comme un objet String.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAs(Type, IXmlNamespaceResolver)Lit le contenu de l'élément en tant que type demandé.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAs(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é.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsAsyncLit de façon asynchrone le contenu de l'élément en tant que type demandé.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsBase64Lit l'élément et décode le contenu au format Base64.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsBase64AsyncLit de façon asynchrone l'élément et décode le contenu au format Base64.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsBinHexLit l'élément et décode le contenu au format BinHex.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsBinHexAsyncLit de façon asynchrone l'élément et décode le contenu au format BinHex.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsBoolean()Lit l'élément actuel et retourne le contenu en tant qu'objet Boolean.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsBoolean(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.
Méthode publiquePris en charge par XNA FrameworkReadElementContentAsDateTime()Lit l'élément actuel et retourne le contenu en tant qu'objet DateTime.
Méthode publiquePris en charge par XNA FrameworkReadElementContentAsDateTime(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsDecimal()Lit l'élément actuel et retourne le contenu en tant qu'objet Decimal.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsDecimal(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsDouble()Lit l'élément actuel et retourne le contenu en tant que nombre à virgule flottante double précision.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsDouble(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsFloat()Lit l'élément actuel et retourne le contenu en tant que nombre à virgule flottante simple précision.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsFloat(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsInt()Lit l'élément actuel et retourne le contenu comme un entier signé de 32 bits.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsInt(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsLong()Lit l'élément actuel et retourne le contenu comme un entier signé de 64 bits.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsLong(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsObject()Lit l'élément actuel et retourne le contenu en tant que Object.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsObject(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsObjectAsyncLit de façon asynchrone l'élément actuel et retourne le contenu en tant que Object.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsString()Lit l'élément actuel et retourne le contenu en tant qu'objet String.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsString(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadElementContentAsStringAsyncLit de façon asynchrone l'élément actuel et retourne le contenu en tant qu'objet String.
Méthode publiquePris en charge par XNA FrameworkReadElementString()Lit un élément de texte brut.
Méthode publiquePris en charge par XNA FrameworkReadElementString(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.
Méthode publiquePris en charge par XNA FrameworkReadElementString(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadEndElementVérifie que le nœud de contenu actuel est une balise de fin et avance le lecteur jusqu'au nœud suivant.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadInnerXmlEn cas de substitution dans une classe dérivée, lit tout le contenu, y compris le balisage, sous forme de chaîne.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadInnerXmlAsyncLit de façon asynchrone tout le contenu, notamment le balisage, en tant que chaîne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadOuterXmlEn 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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadOuterXmlAsyncLit de façon asynchrone le contenu, notamment le balisage, qui représente ce nœud et tous ses enfants.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadStartElement()Vérifie que le nœud actuel est un élément et avance le lecteur jusqu'au nœud suivant.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadStartElement(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadStartElement(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.
Méthode publiquePris en charge par XNA FrameworkReadStringEn cas de substitution dans une classe dérivée, lit le contenu d'un nœud d'élément ou de texte sous forme de chaîne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadSubtreeRetourne une nouvelle instance de XmlReader qui permet de lire le nœud actuel, ainsi que tous ses descendants.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadToDescendant(String)Avance le XmlReader vers l'élément descendant suivant portant le nom qualifié spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadToDescendant(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadToFollowing(String)Lit jusqu'à trouver un élément avec le nom qualifié spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadToFollowing(String, String)Lit jusqu'à trouver un élément avec le nom local et l'URI de l'espace de noms spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadToNextSibling(String)Avance le XmlReader vers l'élément frère suivant portant le nom qualifié spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadToNextSibling(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReadValueChunkLit des flux de texte volumineux incorporés dans un document XML.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreReadValueChunkAsyncLit de façon asynchrone des flux de texte volumineux incorporés dans un document XML.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreResolveEntityEn cas de substitution dans une classe dérivée, résout la référence d'entité des nœuds EntityReference.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSkipIgnore les enfants du nœud actuel.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreSkipAsyncIgnore de façon asynchrone les enfants du nœud actuel.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par XNA FrameworkIDisposable.DisposePour obtenir une description de ce membre, consultez IDisposable.Dispose.
Début

XmlReader fournit un accès en avant uniquement et en lecture seule à un flux de données XML. La classe XmlReader respecte les recommandations du W3C intitulées Extensible Markup Language (XML) 1.0 et Namespaces in XML.

Le nœud actuel fait référence au nœud sur lequel le lecteur est placé. Le lecteur est avancée à l'aide de n'importe laquelle des méthodes de lecture, les propriétés et reflètent la valeur du nœud actuel.

Remarque importanteImportant

Bien que .NET Framework inclut les implémentations concrètes d'XmlReader fichier, par exemple XmlTextReader, XmlNodeReader, et les classes d'XmlValidatingReader, dans la version 2,0 il est conseillé de créer des instances d'XmlReader à l'aide de la méthode de Create. Pour plus d'informations, consultez Création de lecteurs XML.

XmlReader lève XmlException sur les erreurs d'analyse XML. Lorsqu'une exception est levée, l'état du lecteur n'est pas prédictible. Par exemple, le type de nœud enregistré peut être différent du type de nœud réel du nœud actuel. Utilisez la propriété ReadState pour vérifier si l'état du lecteur est Erreur.

Pour obtenir des informations supplémentaires sur la classe XmlReader, consultez Lecture de XML avec XmlReader.

Les méthodes suivantes peuvent être utilisées avec les appels de méthode asynchrone :

Certaines méthodes synchrones ont des équivalents asynchrones qui contiennent « Asynchrone » à la fin de le nom de la méthode. Par exemple, les équivalents asynchrones pour ReadContentAsXxx et les méthodes de ReadElementContentAsXxx sont :

Les sections suivantes décrivent l'utilisation de pour les méthodes qui n'ont pas d'équivalent asynchrones.

ReadStartElement, méthode

public static async Task ReadStartElementAsync(this XmlReader reader, string localname, string ns) {
 if (await 
   reader.MoveToContentAsync() != 
   XmlNodeType.Element) {
 throw new 
InvalidOperationException(
reader.NodeType.ToString() + " is an invalid XmlNodeType");
   }
 if (reader.LocalName == 
     localname && 
     reader.NamespaceURI == ns) {
 await reader.ReadAsync();
   }
 else {
 throw new InvalidOperationException("localName or namespace doesn’t match");
    }
}

Méthode de ReadEndElement

Fonction d'extension :

public static async Task ReadEndElementAsync(this XmlReader reader) {
if (await reader.MoveToContentAsync() != XmlNodeType.EndElement) {
    throw new InvalidOperationException();
   }
 await reader.ReadAsync();
}

Méthode de ReadToNextSibling

public static async Task<bool> ReadToNextSiblingAsync(this XmlReader reader, string localName, string namespaceURI) {
 if (localName == null || 
    localName.Length == 0) {
 throw new ArgumentException ("localName is empty or null");
   }
 if (namespaceURI == null) {
 throw new ArgumentNullException("namespaceURI");
   }

// atomize local name and namespace
   localName = 
    reader.NameTable.Add(localName);
   namespaceURI = 
   reader.NameTable.Add(namespaceURI);

// find the next sibling
 XmlNodeType nt;
 do {
 await reader.SkipAsync();
 if (reader.ReadState !=
 ReadState.Interactive)
 break;
      nt = reader.NodeType;
 if (nt == XmlNodeType.Element &&
      ((object)localName == 
      (object)reader.LocalName) && 
      ((object)namespaceURI == 
      (object)reader.NamespaceURI)) {
 return true;
       }
   }while(nt != XmlNodeType.EndElement 

   && !reader.EOF);
 return false;
}

Méthode de ReadToFollowing

public static async Task<bool> ReadToFollowingAsync(this XmlReader reader, string localName, string namespaceURI) 
{
 if (localName == null || 
     localName.Length == 0) {
 throw new 
     ArgumentException(
     "localName is empty or null");
   }
 if (namespaceURI == null) {
 throw new 
      ArgumentNullException(
     "namespaceURI");
}

// atomize local name and namespace
   localName = 
    reader.NameTable.Add(localName);
   namespaceURI = 
   reader.NameTable.Add(namespaceURI);

// find element with that name
 while (await reader.ReadAsync()) {
 if (reader.NodeType == XmlNodeType.Element && ((object)localName == (object)reader.LocalName) && ((object)namespaceURI == (object)reader.NamespaceURI)) {
 return true;
      }
   }
 return false;
}

Méthode de ReadToDescendant

public static async Task<bool> ReadToDescendantAsync(this XmlReader reader, string localName, string namespaceURI) {
 if (localName == null || localName.Length == 0) {
 throw new ArgumentException("localName is empty or null");
   }
 if (namespaceURI == null) {
 throw new ArgumentNullException("namespaceURI");
   }
 // save the element or root depth
 int parentDepth = reader.Depth;
 if (reader.NodeType != XmlNodeType.Element) {
 // adjust the depth if we are on root node
if (reader.ReadState == ReadState.Initial) {
    parentDepth--;
   }
else {
     return false;
       }
   }
else if (reader.IsEmptyElement) {
   return false;
}

// atomize local name and namespace
localName = reader.NameTable.Add(localName);
namespaceURI = reader.NameTable.Add(namespaceURI);

// find the descendant
while (await reader.ReadAsync() && reader.Depth > parentDepth) {
if (reader.NodeType == XmlNodeType.Element && ((object)localName == (object)reader.LocalName) && ((object)namespaceURI == (object)reader.NamespaceURI)) {
 return true;
}
}
return false;
}

Considérations relatives à la sécurité

Les éléments suivants sont à prendre en compte lors de l'utilisation de la classe XmlReader.

  • Les exceptions levées d'XmlReader peuvent divulgation les informations de chemin d'accès que vous ne souhaitez pas bouillonné jusqu'à l'application. Vos applications doivent intercepter les exceptions et les traiter correctement.

  • N'activez pas le traitement DTD si vous rencontrez des problèmes de déni de service ou si vous traitez avec des sources non fiables. Le traitement DTD est désactivé par défaut pour les objets XmlReader créés par la méthode Create.

    Si le traitement DTD est activé, vous pouvez utiliser XmlSecureResolver pour restreindre les ressources auxquelles XmlReader peut accéder. Vous pouvez également concevoir votre application afin que le traitement XML soit limité en termes de mémoire et de temps. Par exemple, configurez des limites de délai d'expiration dans votre application ASP.NET.

  • Les données XML peuvent inclure des références à des ressources externes telles qu'un fichier de schéma. Les ressources externes sont résolues par défaut en utilisant un objet XmlUrlResolver sans informations d'identification d'utilisateur. Vous pouvez renforcer la sécurité en procédant comme suit :

  • Les indicateurs de validation ProcessInlineSchema et ProcessSchemaLocation d'un objet XmlReaderSettings ne sont pas définis par défaut. Cela contribue à protéger l'objet XmlReader contre les attaques basées sur des schémas lorsqu'il traite des données XML provenant d'une source non fiable. Lorsque ces indicateurs sont définis, le XmlResolver de l'objet XmlReaderSettings permet de résoudre les emplacements de schéma trouvés dans le document d'instance de XmlReader. Si la propriété XmlResolver est définie sur null, les emplacements de schémas ne sont pas résolus, même si les indicateurs de validation ProcessInlineSchema et ProcessSchemaLocation sont activés.

    Les schémas ajoutés lors de la validation ajoutent de nouveaux types et peuvent changer le résultat de la validation du document en cours de validation. En conséquence, les schémas externes doivent être résolus uniquement à partir de sources fiables.

    Nous recommandons de désactiver l'indicateur ProcessIdentityConstraints (activé par défaut) lors de la validation de documents XML volumineux non fiables dans des scénarios de haute disponibilité par rapport à un schéma présentant des contraintes d'identité sur une grande partie du document.

  • Les données XML peuvent contenir un grand nombre d'attributs, de déclarations d'espace de noms, d'éléments imbriqués et autres, qui requièrent une grande durée de traitement. Pour limiter la taille de l'entrée qui est envoyée à XmlReader, vous pouvez :

    • Limitez la taille du document en définissant la propriété d'MaxCharactersInDocument.

    • Limitez le nombre de caractères qui résultent des entités se extension en définissant la propriété d'MaxCharactersFromEntities.

    • Créez une implémentation personnalisée de IStream et fournissez- la XmlReader.

  • La méthode ReadValueChunk peut être utilisée pour gérer de grands flux de données. Cette méthode lit un petit nombre de caractères à la fois au lieu d'allouer une chaîne unique pour la valeur entière.

  • Lors de la lecture d'un document XML avec un grand nombre des noms locaux uniques, d'espaces de noms ou de préfixes, un problème peut survenir. Si vous utilisez une classe qui dérive de XmlReader et que vous appelez la propriété LocalName, Prefix ou NamespaceURI pour chaque élément, la chaîne retournée est ajoutée à un NameTable. La collection détenue par NameTable ne diminue jamais en taille et crée une « fuite de mémoire » virtuelle des handles de chaîne. Il est possible de limiter les risques en dérivant de la classe NameTable et en appliquant un quota de taille maximal. (Il est impossible d'empêcher l'utilisation d'un NameTable ou de faire basculer le NameTable lorsqu'il est complet.) Pour limiter les risques, évitez également d'utiliser les propriétés mentionnées et utilisez plutôt la méthode MoveToAttribute avec la méthode IsStartElement dans la mesure du possible ; ces méthodes ne retournant pas de chaînes, la collection NameTable n'est pas saturée.

  • Les objets XmlReaderSettings peuvent contenir des informations personnelles telles que des informations d'identification de l'utilisateur. Un composant non fiable pourrait utiliser l'objet XmlReaderSettings et ses informations d'identification pour créer des objets XmlReader afin de lire des données. Vous devez être prudent lorsque vous mettez en cache des objets XmlReaderSettings ou lorsque vous passez l'objet XmlReaderSettings d'un composant à un autre.

  • N'acceptez pas la prise en charge de composants, tels que les objets NameTable, XmlNamespaceManager et XmlResolver, provenant d'une source non fiable.

Le code exemple suivant montre comment utiliser l'API asynchrone pour analyser XML.

async Task TestReader(Stream stream) 
{
   XmlReaderSettings settings = new XmlReaderSettings();
   settings.Async = true;

   using (XmlReader reader = XmlReader.Create(stream, settings)) {
      while (await reader.ReadAsync()) {
         switch (reader.NodeType) {
         case XmlNodeType.Element:
            Console.WriteLine("Start Element {0}", reader.Name);
            break;
         case XmlNodeType.Text:
            Console.WriteLine("Text Node: {0}", 
                     await reader.GetValueAsync());
            break;
         case XmlNodeType.EndElement:
              Console.WriteLine("End Element {0}", reader.Name);
              break;
         default:
              Console.WriteLine("Other node {0} with value {1}", 
                              reader.NodeType, reader.Value);
              break;
         }
      }
   }
}

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft