語言

XamlServices.Load 方法

定義

命名空間:
System.Xaml
組件:
System.Xaml.dll

載入 XAML 讀取器的原始碼，並將其輸出寫入為物件圖。

多載

名稱 Description
Load(Stream)

載入 Stream XAML 讀取器的原始碼，並將其輸出寫入物件圖。
Load(TextReader)

從 建立 TextReader一個 XAML 讀取器，並回傳一個物件圖。
Load(String)

載入 Stream XAML 讀取器的原始碼並回傳物件圖。
Load(XamlReader)

載入特定的 XAML 讀取器實作並回傳物件圖。
Load(XmlReader)

載入特定的 XML 讀取器實作並回傳物件圖。

Load(Stream)

載入 Stream XAML 讀取器的原始碼，並將其輸出寫入物件圖。

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) 先建立一個 XmlReader by call Create(Stream) ，然後再建立一個專門化的實例 XamlReader 來處理該輸入。

為了讓呼叫 Load(Stream) 成功建立物件圖，以下條件必須成立：

  • 原始碼為良好且有效的 XML。

  • 原始碼在語言層級是有效的 XAML。

  • 原始 XAML 中指定的 XAML 類型必須解析為相關 XAML 命名空間中的後備類型。 例如，WPF 命名空間的 XAML 類型可以解析為 XAML 中指定的 WPF XAML 命名空間;WPF 的組件必須包含在專案中或執行時可用;依此類推。

Important

XamlServices 如果你正在處理 Windows Presentation Foundation（WPF）型別，或基於 WPF 型別，則不是推薦的 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)

載入 Stream XAML 讀取器的原始碼並回傳物件圖。

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 先建立一個 XmlReader by call 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

XAML 讀取器實作作為此 Load 操作的讀取器。

傳回

Object

回傳的物件圖。

例外狀況

ArgumentNullException

xamlReader 輸入為 null。

備註

通常您應該只在以下情況下使用此簽名：

適用於

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操作的讀取器。

傳回

Object

輸出物件圖。

例外狀況

ArgumentNullException

xmlReader 輸入為 null。

備註

通常只有在你自己定義 XmlReader了 .

適用於