共用方式為


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)內部實作會先呼叫 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

傳回

所傳回的物件圖形。

例外狀況

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內部實作會先呼叫 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 讀取器實作。

傳回

所傳回的物件圖形。

例外狀況

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 實作。

傳回

輸出物件圖形。

例外狀況

xamlReader 輸入是 null

備註

只有在您定義自己的 實作時 XmlReader ,才應該使用此簽章。

適用於