XamlXmlWriter クラス

定義

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

public class XamlXmlWriter : System.Xaml.XamlWriter

type XamlXmlWriter = class
    inherit XamlWriter

Public Class XamlXmlWriter
Inherits XamlWriter

継承

Object

XamlWriter

XamlXmlWriter

注釈

このクラスは、通常、シリアル化シナリオで使用されます。

XamlXmlWriter の使用方法

XamlWriter API には、さまざまな種類の XAML ノードを書き込むいくつかのメソッドがあります。 これらはまとめて、 のメソッドXamlWriterとしてWriteドキュメントで参照されます。 XamlXmlWriter では、いくつかの内部状態クラスを使用して、実装 Write の 1 つが呼び出されたときに何を行うかを決定します。 Write呼び出しでは、状態を使用して、要求された要素、属性、または値を書き込むことができるかどうか、または例外がスローされるかどうかを判断します。 たとえば、 を呼び出 WriteEndObject し、現在のノード位置の XamlXmlWriter 状態が値またはメンバー内にある場合、例外がスローされます。 通常、API の XamlXmlWriter 呼び出し元は、XAML リーダーと XAML ノード ストリームから取得される現在の XAML ノードの型を認識する必要があります。 この知識に基づいて、呼び出し元は、現在のノードの種類に関連しない API を呼び出 Write さないようにする必要があります。

XAML 名前空間と XamlXmlWriter

の XAML 名前空間の XamlXmlWriter 書き込み動作は複雑であり、 への明示的な呼び出しに WriteNamespace限定されません。 代わりに、 などのWriteStartObject他Writeの呼び出しでは、ノード構造の特定のポイントで名前空間宣言を書き込む必要がある場合があります。 XAML ライターは、独自のロジックによってプレフィックスを生成するか、サービスからの情報を INamespacePrefixLookup 使用して優先プレフィックスを決定します。 また、明示的な WriteNamespace 呼び出しでは、XAML 名前空間の宣言が既に適用され、他の場所で宣言されている場合は、遅延または何も返されない可能性があります。

Write メソッドの例外

メソッドによってXamlXmlWriterWriteスローされる例外は、通常、 または XamlXmlWriterExceptionのいずれかInvalidOperationExceptionです。

は InvalidOperationException 、多くの場合、XAML リーダーが無効なノード構造を XAML ノード ストリームに渡したことを示します。 この場合、ノード構造は、XAML スキーマまたは XAML スキーマ コンテキストの検証に関連しない理由で無効です。 代わりに、ノード ストリームは基本的な形式では無効です。 たとえば、障害のある XAML リーダーの実装で、連続する 2 つのノードを含む XAML ノード ストリームが生成された場合、2 StartObject 番目 WriteStartObject の を呼び出そうとすると、 InvalidOperationExceptionがスローされます。 すべての XAML ライターでは、このような操作が無効であると見なされます。 のもう 1 つの例は、現在の InvalidOperationException ノード ストリーム位置に適用される XAML スキーマ コンテキストで XAML 名前空間情報を使用できない場合です。

は XamlXmlWriterException 、この特定の XAML ライター実装が目的の機能に基づいて例外をスローすることを選択する例外を示します。 は XamlXmlWriterException 、独自の状態または設定に XamlXmlWriter 違反する特定のケースを示すことができます。 たとえば、 は、 XamlXmlWriterException XAML 名前空間情報を、 とそのシリアル化形式で XamlXmlWriter サポートされていない位置に書き込もうとしたり、インスタンス XamlXmlWriterSettings が禁止したときに重複するメンバーを書き込んだりした結果として発生する可能性があります。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• Save(Stream, Object)
• XAML ノード ストリームの構造と概念について