XamlXmlWriter Classe

Définition

public ref class XamlXmlWriter : System::Xaml::XamlWriter

public class XamlXmlWriter : System.Xaml.XamlWriter

type XamlXmlWriter = class
    inherit XamlWriter

Public Class XamlXmlWriter
Inherits XamlWriter

Héritage

Object

XamlWriter

XamlXmlWriter

Remarques

Cette classe est généralement utilisée dans les scénarios de sérialisation.

Utilisation de XamlXmlWriter

L’API XamlWriter a plusieurs méthodes qui écrivent différents types de nœuds XAML. Collectivement, on les appelle dans la documentation les méthodes Write d’un XamlWriter. XamlXmlWriter utilise plusieurs classes d’état internes pour déterminer ce qu’il faut faire quand l’une de ses implémentations Write est appelée. Un appel Write utilise les états pour déterminer si l’élément, l’attribut ou la valeur demandé peut être écrit ou si une exception est levée. Par exemple, si vous appelez WriteEndObject et que l’état de la position de nœud actuelle XamlXmlWriter se trouve sur une valeur ou dans un membre, une exception est levée. En règle générale, les appelants de l’API XamlXmlWriter doivent connaître le type du nœud XAML actuel provenant du lecteur XAML et du flux de nœud XAML. En fonction de cette connaissance, les appelants doivent éviter d’appeler Write API qui ne sont pas pertinentes pour le type de nœud actuel.

Espaces de noms XAML et XamlXmlWriter

Le comportement d’écriture d’espace de noms XAML de XamlXmlWriter est complexe et n’est pas limité aux appels explicites à WriteNamespace. Au lieu de cela, d’autres appels Write, tels que WriteStartObject, peuvent exiger que la déclaration d’espace de noms soit écrite à des points particuliers dans la structure du nœud. L’enregistreur XAML génère un préfixe par sa propre logique ou utilise des informations du service INamespacePrefixLookup pour déterminer un préfixe préféré. En outre, les appels de WriteNamespace explicites peuvent différer ou ne renvoyer rien si la déclaration d’espace de noms XAML est déjà applicable et déclarée ailleurs.

Exceptions de méthode Write

Les exceptions levées par les méthodes XamlXmlWriterWrite sont généralement InvalidOperationException ou XamlXmlWriterException.

Un InvalidOperationException indique souvent qu’un lecteur XAML a passé une structure de nœud non valide dans le flux de nœud XAML. Dans ce cas, la structure de nœud n’est pas valide pour des raisons qui ne sont pas liées à la validation d’un schéma XAML ou d’un contexte de schéma XAML. Au lieu de cela, le flux de nœuds n’est pas valide sous sa forme de base. Par exemple, si une implémentation de lecteur XAML défaillante a généré un flux de nœuds XAML qui contenait deux nœuds StartObject consécutifs, la tentative d’appel du deuxième WriteStartObject lèverait une InvalidOperationException. Tous les enregistreurs XAML considèrent qu’une telle opération n’est pas valide. Un autre exemple de InvalidOperationException est le moment où les informations d’espace de noms XAML ne sont pas disponibles via le contexte de schéma XAML qui s’applique à la position actuelle du flux de nœud.

Une XamlXmlWriterException indique une exception dans laquelle cette implémentation d’enregistreur XAML particulière choisit de lever une exception en fonction de ses fonctionnalités prévues. Un XamlXmlWriterException peut indiquer des cas spécifiques où un XamlXmlWriter enfreint son propre état ou ses propres paramètres. Par exemple, un XamlXmlWriterException peut résulter de tentatives d’écriture d’informations d’espace de noms XAML dans une position où le XamlXmlWriter et son format de sérialisation ne prennent pas en charge, ou l’écriture de membres dupliqués lorsque le XamlXmlWriterSettings de l’instance l’interdit.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Save(Stream, Object)
• Présentation des concepts et structures de flux de nœuds XAML