XamlReader Classe

Définition

Espace de noms:

System.Xaml

Assembly:

System.Xaml.dll

Fournit des définitions de base pour les classes qui consomment une entrée XAML et produisent des flux de nœuds XAML.

public ref class XamlReader abstract : IDisposable

public abstract class XamlReader : IDisposable

type XamlReader = class
    interface IDisposable

Public MustInherit Class XamlReader
Implements IDisposable

Héritage

Object

XamlReader

Dérivé

System.Activities.Debugger.XamlDebuggerXmlReader

System.Windows.Baml2006.Baml2006Reader

System.Xaml.XamlBackgroundReader

System.Xaml.XamlObjectReader

System.Xaml.XamlXmlReader

Implémente

IDisposable

Remarques

XamlReader est une classe abstraite et ne fournit pas d’implémentations ou de définitions qui ont un résultat de travail pour tous les membres. Les membres qui ont une implémentation sont XamlReader notés dans les remarques de ce membre. Plus précisément, XamlReader plusieurs membres abstraits doivent être implémentés et plusieurs membres virtuels.

Parmi les membres virtuels, ReadSubtree chacun Skip fournit une implémentation par défaut appropriée pour la plupart des cas. Toutefois, les ReadSubtree implémentations par Skip défaut s’appuient sur d’autres comportements attendus du lecteur XAML d’implémentation ; en particulier, ils s’appuient sur le Read remplacement. Dispose est également un membre virtuel qui a une implémentation par défaut opérationnelle.

Les deux classes suivantes sont les classes dérivées les plus pertinentes et pratiques dans les services XAML .NET Framework et l’assembly System.Xaml :

• XamlObjectReader, qui lit un graphique d’objet, tel que le graphique d’objet actif d’une application au moment de l’exécution.

• XamlXmlReader, qui lit XAML sous la forme d’un fichier texte XML à l’aide d’un général XmlReader qui charge le fichier en tant que classe d’assistance intermédiaire.

D’autres lecteurs XAML d’autres frameworks incluent Baml2006Reader et XamlDebuggerXmlReader.

XamlReader diffère du modèle DOM (Document Object Model) XML et XmlReader des principes de conception, car XamlReader il n’existe pas de Create méthode pour retourner les implémentations de lecteur XAML par défaut sous-jacentes. Vous devez instancier à la place des classes de lecteur XAML dérivées spécifiques en appelant leurs constructeurs ou d’autres API d’assistance spécifiques à une classe.

Lecteurs de sous-arborescence

Pour la plupart, vous appelez XamlReader l’API dans le contexte de classes de lecteur XAML spécifiques qui dérivent de XamlReader. Toutefois, dans un cas particulier, vous accédez à XamlReader l’API sur une instance de lecteur XAML pratique qui n’est pas publique et non dérivée ou XamlObjectReaderXamlXmlReader. Ce cas est le cas lorsque vous appelez ReadSubtree, qui retourne une XamlReader instance. Dans l’implémentation par défaut, celle XamlReader retournée par cette API est une classe interne.

L’objet obtenu pour la XamlReader lecture de sous-arborescence a des actions valides pour les API telles que Read et NodeType, et ces actions sont basées sur la classe de lecteur parente. Cette conception permet à la classe interne de suivre le niveau d’image où la sous-arborescence a été entrée. La sous-arborescence XamlReader agissante garantit que si la position actuelle du nœud est déplacée au-delà des limites de la sous-arborescence, le lecteur de sous-arborescence spécifique signale la fin du fichier ou null au niveau du nœud actuel.

Les remarques relatives à l’utilisation du lecteur de sous-arborescence sont incluses sur certaines XamlReader API.

Constructeurs

Nom	Description
XamlReader()	Initialise la classe XamlReader.

Propriétés

Nom	Description
IsDisposed	Obtient si Dispose(Boolean) elle a été appelée.
IsEof	En cas d’implémentation dans une classe dérivée, obtient une valeur qui indique si la position du lecteur est à la fin du fichier.
Member	En cas d’implémentation dans une classe dérivée, obtient le membre actuel à la position du lecteur, si la position du lecteur se trouve sur un StartMember.
Namespace	En cas d’implémentation dans une classe dérivée, obtient les informations d’espace de noms XAML du nœud actuel.
NodeType	En cas d’implémentation dans une classe dérivée, obtient le type du nœud actuel.
SchemaContext	En cas d’implémentation dans une classe dérivée, obtient un objet qui fournit des informations de contexte de schéma XAML pour le jeu d’informations.
Type	En cas d’implémentation dans une classe dérivée, obtient le XamlType nœud actuel.
Value	En cas d’implémentation dans une classe dérivée, obtient la valeur du nœud actuel.

Méthodes

Nom	Description
Close()	Ferme le flux de nœud XAML.
Dispose(Boolean)	Libère les ressources non managées utilisées par le XamlReader, et éventuellement, libère les ressources managées.
Read()	En cas d’implémentation dans une classe dérivée, fournit le nœud XAML suivant à partir de la source, si un nœud est disponible.
ReadSubtree()	Retourne une XamlReader valeur basée sur le courant XamlReader, où le retour XamlReader est utilisé pour itérer dans une sous-arborescence de la structure de nœud XAML.
Skip()	Ignore le nœud actuel et avance la position du lecteur vers le nœud suivant.

Implémentations d’interfaces explicites

Nom	Description
IDisposable.Dispose()	Libère toutes les ressources utilisées par l’instance actuelle de la XamlReader classe.

Voir aussi

• XamlObjectReader
• XamlXmlReader
• XamlReaderSettings
• Présentation des structures et concepts de flux de nœuds XAML