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) 呼叫成功建立物件圖形，下列專案必須為 true：

• 來源格式正確且有效的 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。 這些類別會在 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。

傳回

Object

所傳回的物件圖形。

例外狀況

ArgumentNullException

textReader 為 null。

備註

若要傳回物件圖形， 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

要載入並做為來源的檔案名稱。

傳回

Object

所傳回的物件圖形。

例外狀況

ArgumentNullException

fileName 輸入是 null。

備註

方法的不同簽章 Load 會為來源 XAML 指定不同類型的輸入。 Load內部實作會先呼叫 Create(String) 來建立 XmlReader ，然後建立處理輸入之特製化 XamlReader 的新實例。

若要讓 Load(String) 呼叫成功建立物件圖形，下列專案必須為 true：

• 來源格式正確且有效的 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 ，才應該使用此簽章。