XamlServices.Load メソッド

定義

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

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

返品

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

例外

streamnullです。

注釈

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

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

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

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

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

Important

XamlServices は、Windows Presentation Foundation (WPF) 型または WPF に基づく型を処理する場合、推奨される XAML 読み取りまたは XAML 書き込み API セットではありません。 WPF を使用する場合は、XAML の読み取りまたは読み込みに System.Windows.Markup.XamlReader を使用し、XAML を書き戻すには System.Windows.Markup.XamlWriter します。 これらのクラスは System.Xaml API を実装で内部的に使用しますが、依存関係プロパティの最適化など、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

返品

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

例外

textReadernullです。

注釈

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

適用対象

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

ソースとして読み込んで使用するファイル名。

返品

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

例外

fileName 入力が null

注釈

Load メソッドのシグネチャによって、ソース XAML に対して異なる種類の入力が指定されます。 Load内部実装では、最初にXmlReaderを呼び出してCreate(String)を作成し、次に入力を処理する特殊な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 リーダーの実装。

返品

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

例外

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

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

返品

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

例外

xmlReader 入力が null

注釈

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

適用対象