XamlObjectWriter Classe

Définition

public ref class XamlObjectWriter : System::Xaml::XamlWriter, System::Xaml::IXamlLineInfoConsumer

public class XamlObjectWriter : System.Xaml.XamlWriter, System.Xaml.IXamlLineInfoConsumer

type XamlObjectWriter = class
    inherit XamlWriter
    interface IXamlLineInfoConsumer

Public Class XamlObjectWriter
Inherits XamlWriter
Implements IXamlLineInfoConsumer

Héritage

Object

XamlWriter

XamlObjectWriter

Implémente

IXamlLineInfoConsumer

Remarques

Les Write méthodes de XamlObjectWriter implémentent un modèle afin que le XamlObjectWriter utilise le XamlWriter qui est défini par la WriteNode méthode . WriteNode la logique bascule entre les Write méthodes, en fonction du type de nœud qui se trouve à la position actuelle dans le lecteur.

Étendue

A XamlObjectWriter un concept d’étendue; autrement dit, conserve XamlObjectWriter un point de référence conceptuel dans son graphe d’objet de sortie. Pour une étendue particulière, certaines opérations peuvent être valides ou non valides, ou produire un résultat sans opération. Par exemple, si vous appelez WriteStartMember pour écrire des directives pour l’initialisation sur un objet qui existe déjà en tant qu’instance, l’implémentation par défaut lève une exception.

Une technique possible de suivi de l’étendue dans un personnalisé XamlObjectWriter consiste à aligner les actions de nœud sur une pile ou une classe frame. La pile ou l’image peut effectuer le suivi de l’envoi (push) et du pop pour chaque niveau de profondeur du modèle objet entré ou sorti pendant l’écriture du XamlObjectWriter graphe d’objets.

Rappels

Pour prendre en charge les scénarios intermédiaires et avancés XamlObjectWriter , le mécanisme d’écriture d’un graphique d’objets fournit des points d’entrée de rappel qui se produisent lorsqu’un XamlObjectWriter commite ou est sur le point de valider certaines actions. Certains rappels sont activés dans les paramètres et ne sont pas spécifiques au type d’objet ou au membre en cours d’écriture ; toutefois, les informations de rappel sont souvent disponibles dans le contexte ou se situent dans les données d’événement envoyées via le rappel. Voici une liste de rappels pertinents :

• Le rappel déclaré par AfterBeginInitHandler est appelé lorsque l’étendue passe à un nouvel objet et à la phase de durée BeginInit de vie de chaque objet créé.

• Le rappel déclaré par AfterEndInitHandler est appelé lorsque l’étendue passe à un nouvel objet et à la phase de durée EndInit de vie de chaque objet créé.

• Le rappel déclaré par BeforePropertiesHandler est appelé lorsque l’étendue démarre dans un objet et se produit lorsque le premier WriteStartMember appel à cette étendue d’objet est effectué, mais pas encore validé.

• Le rappel déclaré par AfterPropertiesHandler est appelé lorsque l’étendue démarre dans un objet et se produit lorsque l’appel WriteEndObject à cette étendue d’objet est effectué, mais pas encore validé.

• Le rappel déclaré par XamlSetValueHandler est appelé quand OnSetValue est appelé.

Écriture de clés de dictionnaire

L’implémentation par défaut de XamlObjectWriter prend en charge la conversion de type sur les contraintes d’un Dictionary<TKey,TValue> avant que le contenu du dictionnaire ne soit ajouté au graphique d’objets. De cette façon, un dictionnaire générique peut être clé au moment de l’exécution par des objets et peut correspondre au comportement générique Add et de l’indexeur approprié. Toutefois, comme implémenté pour la base XamlObjectWriter, cette fonctionnalité existe uniquement pour la création de graphiques d’objets à partir de la classe de base Dictionary<TKey,TValue> et non pour les classes dérivées de Dictionary<TKey,TValue>.

Recherche les données supprimées

Les enregistreurs XAML sont potentiellement utilisés pour les opérations différées ou lorsqu’un appel est effectué sur une instance d’enregistreur XAML qui a été supprimée entre-temps. Différentes API de XamlObjectWriter peuvent être levées ObjectDisposedException dans ces cas.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• XamlWriter
• XamlObjectReader