XamlXmlWriter Klass

Definition

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

public class XamlXmlWriter : System.Xaml.XamlWriter

type XamlXmlWriter = class
    inherit XamlWriter

Public Class XamlXmlWriter
Inherits XamlWriter

Arv

Object

XamlWriter

XamlXmlWriter

Kommentarer

Den här klassen används vanligtvis i serialiseringsscenarier.

Använda XamlXmlWriter

API:et XamlWriter har flera metoder som skriver olika typer av XAML-noder. Tillsammans kallas dessa i dokumentationen för metoderna för Write en XamlWriter. XamlXmlWriter använder flera interna tillståndsklasser för att avgöra vad som ska utföras när en av dess Write implementeringar anropas. Ett Write anrop använder tillstånden för att avgöra om det begärda elementet, attributet eller värdet kan skrivas eller om ett undantag genereras. Om du till exempel anropar WriteEndObject och tillståndet för den aktuella nodpositionen XamlXmlWriter är på ett värde eller inom en medlem genereras ett undantag. Normalt bör anropare av API:et XamlXmlWriter vara medvetna om vilken typ av aktuell XAML-nod som kommer från XAML-läsaren och XAML-nodströmmen. Utifrån den här kunskapen bör anropare undvika att anropa Write API:er som inte är relevanta för den aktuella nodtypen.

XAML-namnområden och XamlXmlWriter

Skrivbeteendet XamlXmlWriter för XAML-namnområdet är komplext och är inte begränsat till explicita anrop till WriteNamespace. I stället kan andra Write anrop, till exempel WriteStartObject, kräva att namnområdesdeklarationen skrivs vid vissa punkter i nodstrukturen. XAML-skrivaren genererar antingen ett prefix med sin egen logik eller använder information från tjänsten för att fastställa ett föredraget INamespacePrefixLookup prefix. Dessutom kan explicita WriteNamespace anrop skjutas upp eller returnera ingenting om XAML-namnområdesdeklarationen redan är tillämplig och deklarerad någon annanstans.

Undantag för skrivmetod

Undantag som genereras av XamlXmlWriterWrite metoderna är vanligtvis antingen InvalidOperationException eller XamlXmlWriterException.

En InvalidOperationException indikerar ofta att en XAML-läsare skickade en ogiltig nodstruktur till XAML-nodströmmen. I det här fallet är nodstrukturen ogiltig av skäl som inte är relaterade till validering av ett XAML-schema eller en XAML-schemakontext. Nodströmmen är i stället ogiltig i sin grundläggande form. Om en felaktig XAML-läsarimplementering till exempel genererade en XAML-nodström som innehöll två på varandra följande StartObject noder, skulle försöket att anropa den andra WriteStartObject utlösa en InvalidOperationException. Alla XAML-skrivare anser att en sådan åtgärd är ogiltig. Ett annat exempel på ett InvalidOperationException är när XAML-namnområdesinformation inte är tillgänglig via XAML-schemakontexten som gäller för den aktuella nodströmspositionen.

A XamlXmlWriterException anger ett undantag där just den här XAML-skrivarimplementeringen väljer att utlösa ett undantag baserat på dess avsedda funktioner. En XamlXmlWriterException kan ange specifika fall där en XamlXmlWriter bryter mot sitt eget tillstånd eller inställningar. Till exempel kan ett XamlXmlWriterException resultat av försök att skriva XAML-namnområdesinformation till en position som XamlXmlWriter och dess serialiseringsformat inte stöder, eller att dubblettmedlemmar skrivs XamlXmlWriterSettings när instansen förbjuder den.

Se även

• Save(Stream, Object)
• Förstå XAML Node Stream-strukturer och begrepp