Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

XmlTextReader, classe

.NET Framework 4

Autres versions

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

Hiérarchie d'héritage

System.Object
System.Xml.XmlReader
System.Xml.XmlTextReader

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

Syntaxe

C++

Copier

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class XmlTextReader : XmlReader, 
	IXmlLineInfo, IXmlNamespaceResolver

Le type XmlTextReader expose les membres suivants.

Constructeurs

	Nom	Description
	XmlTextReader()	Initialise une nouvelle instance de XmlTextReader.
	XmlTextReader(Stream)	Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié.
	XmlTextReader(String)	Initialise une nouvelle instance de la classe XmlTextReader avec le fichier spécifié.
	XmlTextReader(TextReader)	Initialise une nouvelle instance de la classe XmlTextReader avec le TextReader spécifié.
	XmlTextReader(XmlNameTable)	Infrastructure. Initialise une nouvelle instance de la classe XmlTextReader avec le XmlNameTable spécifié.
	XmlTextReader(Stream, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec le flux spécifié et XmlNameTable.
	XmlTextReader(String, Stream)	Initialise une nouvelle instance de la classe XmlTextReader avec l'URL et le flux 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, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec le fichier et le XmlNameTable spécifiés.
	XmlTextReader(TextReader, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec les TextReader et XmlNameTable spécifiés.
	XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Initialise une nouvelle instance de la classe XmlTextReader avec le flux, le XmlNodeType et le XmlParserContext 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, XmlNameTable)	Initialise une nouvelle instance de la classe XmlTextReader avec l'URL, ainsi que les TextReader et 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.

Début

Propriétés

	Nom	Description
	AttributeCount	Obtient le nombre d'attributs du nœud actuel. (Substitue XmlReader.AttributeCount.)
	BaseURI	Obtient l'URI de base du nœud actuel. (Substitue XmlReader.BaseURI.)
	CanReadBinaryContent	Obtient une valeur qui indique si XmlTextReader implémente les méthodes de lecture de contenu binaire. (Substitue XmlReader.CanReadBinaryContent.)
	CanReadValueChunk	Obtient une valeur indiquant si XmlTextReader implémente la méthode ReadValueChunk spécifiée. (Substitue XmlReader.CanReadValueChunk.)
	CanResolveEntity	Obtient une valeur indiquant si ce lecteur peut analyser et résoudre les entités. (Substitue XmlReader.CanResolveEntity.)
	Depth	Obtient la profondeur du nœud actuel dans le document XML. (Substitue XmlReader.Depth.)
	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. (Substitue XmlReader.EOF.)
	HasAttributes	Obtient une valeur indiquant si le nœud actuel possède des attributs. (Hérité de XmlReader.)
	HasValue	Obtient une valeur indiquant si le nœud actuel peut avoir une Value autre que String.Empty. (Substitue XmlReader.HasValue.)
	IsDefault	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. (Substitue XmlReader.IsDefault.)
	IsEmptyElement	Obtient une valeur indiquant si le nœud actuel est un élément vide (par exemple, <MyElement/>). (Substitue XmlReader.IsEmptyElement.)
	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]	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.)
	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.)
	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. (Substitue XmlReader.LocalName.)
	Name	Obtient le nom qualifié du nœud actuel. (Substitue XmlReader.Name.)
	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é. (Substitue XmlReader.NamespaceURI.)
	NameTable	Obtient le XmlNameTable associé à cette implémentation. (Substitue XmlReader.NameTable.)
	NodeType	Obtient le type du nœud actuel. (Substitue XmlReader.NodeType.)
	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. (Substitue XmlReader.Prefix.)
	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. (Substitue XmlReader.QuoteChar.)
	ReadState	Obtient l'état du lecteur. (Substitue XmlReader.ReadState.)
	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.) Dans XNA Framework, ce membre est substitué par Settings.
	Value	Obtient le texte du nœud actuel. (Substitue XmlReader.Value.)
	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 xml:lang en cours. (Substitue XmlReader.XmlLang.)
	XmlResolver	Définit le XmlResolver utilisé pour la résolution des références DTD.
	XmlSpace	Obtient la portée xml:space en cours. (Substitue XmlReader.XmlSpace.)

Début

Méthodes

	Nom	Description
	Close	Modification de ReadState en Closed. (Substitue XmlReader.Close().)
	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'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetAttribute(Int32)	Obtient la valeur de l'attribut avec l'index spécifié. (Substitue XmlReader.GetAttribute(Int32).)
	GetAttribute(String)	Obtient la valeur de l'attribut avec le nom spécifié. (Substitue XmlReader.GetAttribute(String).)
	GetAttribute(String, String)	Obtient la valeur de l'attribut avec le nom local et l'URI d'espace de noms spécifiés. (Substitue XmlReader.GetAttribute(String, String).)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetNamespacesInScope	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.)
	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	Résout un préfixe de l'espace de noms dans la portée de l'élément en cours. (Substitue XmlReader.LookupNamespace(String).)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	MoveToAttribute(Int32)	Se déplace vers l'attribut avec l'index spécifié. (Substitue XmlReader.MoveToAttribute(Int32).)
	MoveToAttribute(String)	Se déplace vers l'attribut avec le nom spécifié. (Substitue XmlReader.MoveToAttribute(String).)
	MoveToAttribute(String, String)	Se déplace vers l'attribut avec le nom local et l'URI d'espace de noms spécifiés. (Substitue XmlReader.MoveToAttribute(String, String).)
	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.)
	MoveToElement	Se déplace vers l'élément contenant le nœud d'attribut actuel. (Substitue XmlReader.MoveToElement().)
	MoveToFirstAttribute	Se déplace vers le premier attribut. (Substitue XmlReader.MoveToFirstAttribute().)
	MoveToNextAttribute	Se déplace vers l'attribut suivant. (Substitue XmlReader.MoveToNextAttribute().)
	Read	Lit le nœud suivant du flux. (Substitue XmlReader.Read().)
	ReadAttributeValue	Analyse la valeur d'attribut selon un ou plusieurs nœuds Text, EntityReference ou EndEntity. (Substitue XmlReader.ReadAttributeValue().)
	ReadBase64	Décode Base64 et retourne les octets binaires décodés.
	ReadBinHex	Décode BinHex et retourne les octets binaires décodés.
	ReadChars	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	Lit le contenu en tant qu'objet du type spécifié. (Hérité de XmlReader.)
	ReadContentAsBase64	Lit le contenu et retourne les octets binaires décodés au format Base64. (Substitue XmlReader.ReadContentAsBase64(Byte[], Int32, Int32).)
	ReadContentAsBinHex	Lit le contenu et retourne les octets binaires décodés au format BinHex. (Substitue XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32).)
	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.)
	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.)
	ReadContentAsString	Lit 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.)
	ReadElementContentAsBase64	Lit l'élément et décode le contenu Base64. (Substitue XmlReader.ReadElementContentAsBase64(Byte[], Int32, Int32).)
	ReadElementContentAsBinHex	Lit l'élément et décode le contenu au format BinHex. (Substitue XmlReader.ReadElementContentAsBinHex(Byte[], Int32, Int32).)
	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.)
	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.)
	ReadElementString()	Lit un élément de texte brut. (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. (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. (Hérité de XmlReader.)
	ReadEndElement	Vérifie que le nœud de contenu actuel est une balise 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.)
	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.)
	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. (Substitue XmlReader.ReadString().)
	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 le nœud frère suivant doté du nom local et de l'URI de l'espace de noms spécifiés. (Hérité de XmlReader.)
	ReadValueChunk	Lit 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é des nœuds EntityReference. (Substitue XmlReader.ResolveEntity().)
	Skip	Ignore les enfants du nœud actuel. (Substitue XmlReader.Skip().)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Implémentations d'interface explicite

	Nom	Description
	IDisposable.Dispose	Pour obtenir une description de ce membre, consultez IDisposable.Dispose. (Hérité de XmlReader.)
	IXmlNamespaceResolver.GetNamespacesInScope	Pour obtenir une description de ce membre, consultez IXmlNamespaceResolver.GetNamespacesInScope.
	IXmlNamespaceResolver.LookupNamespace	Pour obtenir une description de ce membre, consultez IXmlNamespaceResolver.LookupNamespace.
	IXmlNamespaceResolver.LookupPrefix	Pour obtenir une description de ce membre, consultez IXmlNamespaceResolver.LookupPrefix.

Début

Notes

Remarque
Dans la version .NET Framework version 2.0, la méthode recommandée consiste à créer des instances de XmlReader à l'aide de la méthode XmlReader.Create. Cela vous permet de tirer pleinement parti des nouvelles fonctionnalités incluses dans cette version. Pour plus d'informations, consultez Création de lecteurs XML.

XmlTextReader fournit un accès en avant uniquement et en lecture seule à un flux de données XML. Le nœud actuel fait référence au nœud sur lequel le lecteur est placé. Le lecteur avance à l'aide des méthodes de lecture tandis que les propriétés reflètent la valeur du nœud actuel.

Cette classe implémente XmlReader et respecte les recommandations du W3C intitulées Extensible Markup Language (XML) 1.0 et Namespaces in XML. XmlTextReader fournit les fonctionnalités suivantes :

Applique les règles nécessaires à l'obtention d'un code XML correct.
XmlTextReader ne fournit pas de validation des données.
Vérifie que les nœuds DocumentType sont de forme correcte. XmlTextReader vérifie la construction correcte du DTD, mais n'effectue pas de validation à l'aide du DTD.
Pour les nœuds dont NodeType est XmlNodeType.EntityReference, un seul nœud vide EntityReference est retourné (c'est-à-dire que la propriété Value est String.Empty).

Remarque
Les déclarations réelles des entités dans la DTD sont qualifiées de nœuds Entity. Lorsque vous faites référence à ces nœuds dans vos données, ils sont appelés nœuds EntityReference.

Ne développe pas les attributs par défaut.

XmlTextReader n'effectue pas les vérifications supplémentaires requises pour la validation des données, par conséquent, il fournit un analyseur qui examine rapidement si un contenu est correct.

Pour effectuer une validation des données, utilisez un XmlReader de validation. Pour plus d'informations, consultez Validation de données XML avec XmlReader.

Pour lire des données XML à partir de XmlDocument, utilisez XmlNodeReader.

XmlTextReader lève XmlException sur les erreurs d'analyse XML. Lorsqu'une exception est levée, l'état du lecteur est imprévisible. Par exemple, le type de nœud rapporté peut différer du type réel du nœud actuel. Utilisez la propriété ReadState pour vérifier si l'état d'un lecteur est Erreur.

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

Considérations à propos de la sécurité

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

Les exceptions levées par XmlTextReader peuvent divulguer des informations relatives au chemin d'accès dont vous ne souhaitez pas qu'elles soient propagées dans l'application. Vos applications doivent intercepter les exceptions et les traiter correctement.
Le traitement DTD est activé par défaut. Désactivez le traitement DTD si vous rencontrez des problèmes de déni de service ou si vous devez gérer des sources non fiables. Affectez la valeur Prohibit à la propriété DtdProcessing pour désactiver le traitement DTD.

Si le traitement DTD est activé, vous pouvez utiliser XmlSecureResolver pour restreindre les ressources auxquelles XmlTextReader 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 DTD. 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 :
- Limitez les ressources auxquelles XmlTextReader peut accéder en définissant la propriété XmlResolver sur un objet XmlSecureResolver.
- N'autorisez pas XmlReader à ouvrir n'importe quelle ressource externe en affectant à la propriété XmlResolver la valeur null.
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 au XmlTextReader, créez une implémentation IStream personnalisée et affectez-lui XmlTextReader.
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.
Par défaut, les entités générales ne sont pas développées. Des entités générales sont développées lorsque vous appelez la méthode ResolveEntity.

Remarques à l'attention des héritiers

Cette classe a une demande d'héritage. Une confiance totale est requise pour hériter de XmlTextReader. Consultez Demandes d'héritage pour plus d'informations.

Informations de version

.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.

Sécurité des threads

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.

Voir aussi

Référence

System.Xml, espace de noms

Autres ressources

Documents et données XML

Sécurité et applications system.xml

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Contenu de la communauté Ajouter

FAQ