XamlReader クラス

リファレンス

定義

名前空間:: System.Xaml

アセンブリ:: System.Xaml.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

XAML 入力を処理して XAML ノードストリームを生成するクラスの基本定義を提供します。

public ref class XamlReader abstract : IDisposable

public abstract class XamlReader : IDisposable

type XamlReader = class
    interface IDisposable

Public MustInherit Class XamlReader
Implements IDisposable

継承: Object
XamlReader

派生: System.Activities.Debugger.XamlDebuggerXmlReader

System.Windows.Baml2006.Baml2006Reader

System.Xaml.XamlBackgroundReader

System.Xaml.XamlObjectReader

System.Xaml.XamlXmlReader

実装: IDisposable

注釈

XamlReader は抽象クラスであり、すべてのメンバーに対して動作結果を持つ実装または定義を提供しません。実装 XamlReader を行っているメンバーは、そのメンバーの備考に記されています。具体的には、 XamlReader 実装する必要があるいくつかの抽象メンバーと複数の仮想メンバーがあります。

仮想メンバーのうち、 ReadSubtree Skip ほとんどの場合に適した既定の実装が提供されます。ただし、既定の ReadSubtree 実装は Skip 、実装する XAML リーダーの他の予期される動作に依存します。特に、オーバーライドに Read 依存します。 Dispose は、動作する既定の実装を持つ仮想メンバーでもあります。

次の 2 つのクラスは、.NET Framework XAML サービスと System.Xaml アセンブリで最も関連性が高く実用的な派生クラスです。

XamlObjectReader: 実行時にアプリケーションのアクティブなオブジェクトグラフなどのオブジェクトグラフを読み取ります。
XamlXmlReader:中間ヘルパークラスとしてファイルを読み込む一般 XmlReader を使用して、XML テキストファイルの形式で XAML を読み取ります。

他のフレームワークの他の XAML リーダーには、次XamlDebuggerXmlReaderのものが含まれますBaml2006Reader。

XamlReaderは、基になる既定の XAML リーダー実装を返すメソッドがないためXamlReaderCreate、XML ドキュメントオブジェクトモデル (DOM) やXmlReader設計原則とは異なります。代わりに、コンストラクターまたはその他のクラス固有のヘルパー API を呼び出して、特定の派生 XAML リーダークラスをインスタンス化する必要があります。

サブツリーリーダー

ほとんどの場合、派生元の特定の XAML リーダークラスXamlReaderのコンテキストで API を呼び出XamlReaderします。ただし、特定のケースでは、パブリックではなく、派生XamlObjectReaderしていない実用的な XAML リーダーインスタンス上の API にアクセスXamlReaderしますXamlXmlReader。このケースは、インスタンスを返す呼び出し ReadSubtree時です XamlReader 。既定の実装では、 XamlReader この API によって返されるクラスは内部クラスです。

XamlReaderサブツリー読み取り用に取得された API には、次のようなNodeType Read有効なアクションがあり、それらのアクションは親リーダークラスに基づいています。この設計により、内部クラスはサブツリーが入力されたフレームレベルを追跡できます。動作するサブツリー XamlReader は、現在のノード位置がサブツリーの境界を超えて移動された場合、特定のサブツリーリーダーがファイルの末尾または null 現在のノードで報告することを確認します。

サブツリーリーダーの使用状況に関するメモは、特定 XamlReader の API に含まれています。

コンストラクター

XamlReader()

XamlReader クラスを初期化します。

プロパティ

IsDisposed	Dispose(Boolean) が呼び出されているかどうかを取得します。
IsEof	派生クラスで実装されている場合に、リーダーがファイルの末尾に配置されているかどうかを示す値を取得します。
Member	派生クラスで実装されており、リーダーが StartMember 上に配置されている場合は、リーダーが現在配置されているメンバーを取得します。
Namespace	派生クラスで実装されている場合に、現在のノードから XAML 名前空間情報を取得します。
NodeType	派生クラスで実装された場合、現在のノードの型を取得します。
SchemaContext	派生クラスで実装されている場合に、情報セットに XAML スキーマコンテキスト情報を提供するオブジェクトを取得します。
Type	派生クラスで実装されている場合に、現在のノードの XamlType を取得します。
Value	派生クラスで実装された場合、現在のノードの値を取得します。

メソッド

Close()	XAML ノードストリームを閉じます。
Dispose(Boolean)	XamlReader によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Read()	派生クラスで実装された場合、処理対象から次の XAML ノードを読み取ります (ノードがある場合)。
ReadSubtree()	現在の XamlReader に基づく XamlReader を返します。返された XamlReader は、XAML ノード構造のサブツリーでの反復処理に使用されます。
Skip()	現在のノードをスキップして、リーダーの位置を次のノードに進めます。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

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

IDisposable.Dispose()

XamlReader クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。

適用対象