XamlServices.Load メソッド

定義

名前空間:

System.Xaml

アセンブリ:

System.Xaml.dll

XAML リーダーの読み取り元を読み込み、その出力をオブジェクト グラフとして書き込みます。

オーバーロード

Load(Stream)	XAML リーダーの読み取り元の Stream を読み込み、その出力をオブジェクト グラフとして書き込みます。
Load(TextReader)	TextReader から XAML リーダーを作成し、オブジェクト グラフを返します。
Load(String)	XAML リーダーの読み取り元の Stream を読み込み、オブジェクト グラフを返します。
Load(XamlReader)	固有の XAML リーダー実装を読み込み、オブジェクト グラフを返します。
Load(XmlReader)	固有の XML リーダー実装を読み込み、オブジェクト グラフを返します。

Load(Stream)

XAML リーダーの読み取り元の Stream を読み込み、その出力をオブジェクト グラフとして書き込みます。

public:
 static System::Object ^ Load(System::IO::Stream ^ stream);

public static object Load (System.IO.Stream stream);

static member Load : System.IO.Stream -> obj

Public Shared Function Load (stream As Stream) As Object

パラメーター

stream

Stream

入力として読み込むストリーム。

戻り値

Object

出力として書き込まれるオブジェクト グラフ。

例外

ArgumentNullException

stream が nullです。

注釈

メソッドのシグネチャによって、 Load(Stream) ソース XAML に対して異なる種類の入力が指定されます。 内部実装ではLoad(Stream)、まず を呼び出Create(Stream)して をXmlReader作成し、入力を処理する特殊化された XamlReader の新しいインスタンスを作成します。

呼び出しで Load(Stream) オブジェクト グラフが正常に作成されるようにするには、次の条件が満たされている必要があります。

• ソースは整形式で有効な XML です。

• ソースは、言語レベルで有効な XAML です。

• ソース XAML で指定された XAML 型は、関連する XAML 名前空間のバッキング型に解決される必要があります。 たとえば、WPF 名前空間の XAML 型は、XAML で指定されている WPF XAML 名前空間に解決できます。WPF のアセンブリは、プロジェクトに含めるか、実行時に使用できる必要があります。などなど。

重要

XamlServicesは、WINDOWS PRESENTATION FOUNDATION (WPF) 型、または WPF に基づく型を処理する場合は、推奨される XAML 読み取りまたは XAML 書き込み API セットではありません。 WPF を使用する場合は、 を使用して System.Windows.Markup.XamlReader XAML の読み取りまたは読み込みを行い、 System.Windows.Markup.XamlWriter XAML を書き戻します。 これらのクラスは、実装で内部的に API を使用 System.Xaml しますが、依存関係プロパティの最適化など、XAML の読み取りと書き込みの性質に影響を与える WPF 固有の概念のサポートも提供します。

Load(TextReader)

TextReader から XAML リーダーを作成し、オブジェクト グラフを返します。

public:
 static System::Object ^ Load(System::IO::TextReader ^ textReader);

public static object Load (System.IO.TextReader textReader);

static member Load : System.IO.TextReader -> obj

Public Shared Function Load (textReader As TextReader) As Object

パラメーター

textReader

TextReader

作成する TextReader の基礎として使用する XmlReader。

戻り値

Object

返されるオブジェクト グラフ。

例外

ArgumentNullException

textReader が nullです。

注釈

オブジェクト グラフを返すには、関連する入力を textReader 使用して入力を構築する必要があります。 たとえば、コンストラクターの有効な文字列としての XAML 入力StringReader(String)を使用して構築された を渡すStringReader必要があります。

Load(String)

XAML リーダーの読み取り元の Stream を読み込み、オブジェクト グラフを返します。

public:
 static System::Object ^ Load(System::String ^ fileName);

public static object Load (string fileName);

static member Load : string -> obj

Public Shared Function Load (fileName As String) As Object

パラメーター

fileName

String

読み込み元として使用するファイル名。

戻り値

Object

返されるオブジェクト グラフ。

例外

ArgumentNullException

fileName の入力が null です。

注釈

メソッドのシグネチャによって、 Load ソース XAML に対して異なる種類の入力が指定されます。 内部実装ではLoad、まず を呼び出Create(String)して をXmlReader作成し、入力を処理する特殊化された XamlReader の新しいインスタンスを作成します。

呼び出しで Load(String) オブジェクト グラフが正常に作成されるようにするには、次の条件が満たされている必要があります。

• ソースは整形式で有効な XML です。

• ソースは、言語レベルで有効な XAML です。

• ソース XAML で指定された XAML 型は、関連する XAML 名前空間のバッキング型に解決される必要があります。 たとえば、WPF 名前空間の XAML 型は、XAML で指定されている WPF XAML 名前空間に解決できます。WPF のアセンブリは、プロジェクトに含めるか、実行時に使用できる必要があります。などなど。

Load(XamlReader)

固有の XAML リーダー実装を読み込み、オブジェクト グラフを返します。

public:
 static System::Object ^ Load(System::Xaml::XamlReader ^ xamlReader);

public static object Load (System.Xaml.XamlReader xamlReader);

static member Load : System.Xaml.XamlReader -> obj

Public Shared Function Load (xamlReader As XamlReader) As Object

パラメーター

xamlReader

XamlReader

この Load 操作のリーダーとして使用する XAML リーダー実装。

戻り値

Object

返されるオブジェクト グラフ。

例外

ArgumentNullException

xamlReader の入力が null です。

注釈

通常、この署名は次の場合にのみ使用する必要があります。

• の独自の実装を定義しました XamlReader。

• 既定の設定とは異なる の XamlReader 設定を指定しました。

Load(XmlReader)

固有の XML リーダー実装を読み込み、オブジェクト グラフを返します。

public:
 static System::Object ^ Load(System::Xml::XmlReader ^ xmlReader);

public static object Load (System.Xml.XmlReader xmlReader);

static member Load : System.Xml.XmlReader -> obj

Public Shared Function Load (xmlReader As XmlReader) As Object

パラメーター

xmlReader

XmlReader

この Load 操作のリーダーとして使用する XmlReader 実装。

戻り値

Object

出力されたオブジェクト グラフ。

例外

ArgumentNullException

xamlReader の入力が null です。

注釈

通常、この署名は、 の独自の実装を定義した場合にのみ使用する XmlReader必要があります。