Partager via


XamlReader Classe

Définition

Fournit les définitions de base des classes qui consomment des entrées XAML et produisent des flux de données de nœud 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
XamlReader
Dérivé
Implémente

Remarques

XamlReader est une classe abstraite et ne fournit pas d’implémentations ou de définitions qui ont un résultat opérationnel pour tous les membres. Les membres qui ont une mise en XamlReader œuvre sont 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 et Skip les implémentations par 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 .NET Framework services XAML 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 des principes dom (Document Object Model) XML et XmlReader 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 à la classe.

Lecteurs de sous-arborescence

Dans la plupart des cas, 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 XamlObjectReader XamlXmlReader. Ce cas est le cas lorsque vous appelez ReadSubtree, qui retourne une XamlReader instance. Dans l’implémentation par défaut, celui XamlReader retourné par cette API est une classe interne.

La XamlReader lecture de sous-arborescences a des actions valides pour les API telles que Read et NodeType, et ces actions sont basées sur la classe de lecteur parent. Cette conception permet à la classe interne de suivre le niveau de trame 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 notes relatives à l’utilisation du lecteur de sous-arborescence sont incluses sur certaines XamlReader API.

Constructeurs

XamlReader()

Initialise la classe XamlReader.

Propriétés

IsDisposed

Obtient une valeur indiquant si Dispose(Boolean) a été appelé.

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 est sur un StartMember.

Namespace

En cas d'implémentation dans une classe dérivée, obtient des informations sur l'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 du nœud actuel.

Value

En cas d'implémentation dans une classe dérivée, obtient la valeur du nœud actuel.

Méthodes

Close()

Ferme le flux de données de nœud XAML.

Dispose(Boolean)

Libère les ressources non managées utilisées par XamlReader, et libère éventuellement les ressources managées.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Read()

En cas d'implémentation dans une classe dérivée, fournit le nœud XAML suivant depuis la source, si un nœud est disponible.

ReadSubtree()

Retourne un XamlReader qui est basé sur le XamlReaderactuel, où le XamlReader retourné est utilisé pour itérer au sein d'une sous-arborescence de la structure de nœud XAML.

Skip()

Ignore le nœud actuel et avance la position du lecteur au nœud suivant.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Libère toutes les ressources utilisées par l'instance actuelle de la classe XamlReader.

S’applique à

Voir aussi