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 Write méthodes d’un XamlWriter. XamlXmlWriter utilise plusieurs classes d’état internes pour déterminer ce qu’il faut faire quand l’une de ses Write implémentations est appelée. Un Write appel 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 XamlXmlWriter position du nœud actuel 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 des API qui ne sont pas pertinentes pour le type de nœud actuel.

Espaces de noms XAML et XamlXmlWriter

Le comportement d’écriture de l’espace de noms XAML est XamlXmlWriter complexe et n’est pas limité aux appels explicites à WriteNamespace. Au lieu de cela, d’autres Write appels, tels que WriteStartObject, peuvent exiger que la déclaration d’espace de noms soit écrite à des points particuliers dans la structure de nœud. L’enregistreur XAML génère un préfixe par sa propre logique ou utilise des informations du INamespacePrefixLookup service pour déterminer un préfixe préféré. En outre, les appels explicites WriteNamespace 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 XamlXmlWriterWrite méthodes sont généralement soit .XamlXmlWriterExceptionInvalidOperationException

Un InvalidOperationException lecteur XAML indique souvent qu’un lecteur XAML a passé une structure de nœud non valide dans le flux de nœuds 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éfectueuse a généré un flux de nœuds XAML qui contenait deux nœuds consécutifs StartObject , la tentative d’appel de la seconde WriteStartObject lève un InvalidOperationException. Tous les enregistreurs XAML considèrent qu’une telle opération n’est pas valide. Un autre exemple est le moment où les informations d’espace de InvalidOperationException noms XAML ne sont pas disponibles via le contexte de schéma XAML qui s’applique à la position actuelle du flux de nœud.

A 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ù une XamlXmlWriter violation de son propre état ou de ses propres paramètres. Par exemple, une XamlXmlWriterException tentative d’écriture d’informations d’espace de noms XAML dans une position où le format de sérialisation et le XamlXmlWriter format de sérialisation ne prennent pas en charge ou écrivent des membres dupliqués lorsque l’instance l’interdit XamlXmlWriterSettings .

Voir aussi

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