XamlObjectWriter Klass

Definition

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

Arv

Object

XamlWriter

XamlObjectWriter

Implementeringar

IXamlLineInfoConsumer

Kommentarer

Metoderna Write för XamlObjectWriter att implementera ett mönster så att XamlObjectWriter använder XamlWriter som definieras av WriteNode metoden. WriteNode logikväxlar mellan Write metoderna, beroende på vilken nodtyp som befinner sig på den aktuella positionen i läsaren.

Scope

A XamlObjectWriter har ett omfångsbegrepp, det vill ex. XamlObjectWriter underhåller en konceptuell referenspunkt i utdataobjektdiagrammet. För ett visst omfång kan vissa åtgärder vara giltiga eller ogiltiga eller generera ett resultat utan åtgärd. Om du till exempel anropar WriteStartMember för att skriva direktiv för initiering av ett objekt som redan finns som en instans, utlöser standardimplementeringen ett undantag.

En möjlig teknik för att spåra omfång i en anpassad XamlObjectWriter är att justera nodåtgärderna med en stack- eller ramklass. Stacken eller ramen kan hålla reda på push och pop för varje nivå av objektmodelldjup som anges eller avslutas när XamlObjectWriter objektdiagrammet skrivs.

Återanrop

För att stödja mellanliggande och avancerade XamlObjectWriter scenarier tillhandahåller mekanismen för att skriva ett objektdiagram startpunkter för återanrop som inträffar när en XamlObjectWriter incheckning eller är på väg att genomföra vissa åtgärder. Vissa återanrop är aktiverade i inställningarna och är inte specifika för objekttypen eller den medlem som skrivs. Återanropsinformation är dock ofta tillgänglig i kontexten eller finns i händelsedata som skickas via återanropet. Följande är en lista över relevanta återanrop:

• Återanropet som deklareras av AfterBeginInitHandler anropas när omfånget går till ett nytt objekt och vid BeginInit fasen av objektets livslängd för varje skapat objekt.

• Återanropet som deklareras av AfterEndInitHandler anropas när omfånget går till ett nytt objekt och vid EndInit fasen av objektets livslängd för varje skapat objekt.

• Återanropet som deklareras av BeforePropertiesHandler anropas när omfånget startar i ett objekt och inträffar när det första WriteStartMember anropet till objektomfånget görs men inte har bekräftats ännu.

• Återanropet som deklareras av AfterPropertiesHandler anropas när omfånget startar i ett objekt och inträffar när anropet WriteEndObject till objektets omfång görs men inte har bekräftats ännu.

• Återanropet som deklareras av XamlSetValueHandler anropas när OnSetValue anropas.

Skriva ordlistenycklar

Standardimplementeringen av XamlObjectWriter stöder typkonvertering på begränsningarna för en Dictionary<TKey,TValue> innan ordlisteinnehållet läggs till i objektdiagrammet. På så sätt kan en allmän ordlista nyckelas vid körning av objekt och matcha det relevanta allmänna Add beteendet och indexerarens beteende. Men som implementerats för basen XamlObjectWriterfinns den här funktionen endast för att skapa objektdiagram från basklassen Dictionary<TKey,TValue> och inte för härledda klasser av Dictionary<TKey,TValue>.

Söker efter borttagen

XAML-skrivare används potentiellt för uppskjutna åtgärder eller där ett anrop görs mot en XAML-skrivinstans som har tagits bort under tiden. Olika API:er för XamlObjectWriter kan utlösas ObjectDisposedException i dessa fall.

Se även

• XamlWriter
• XamlObjectReader