XamlServices.Save 方法

定義

命名空間:: System.Xaml

組件:: System.Xaml.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將所提供的物件圖處理成 XAML 節點表示，然後再轉為輸出格式以進行序列化。

多載

名稱	Description
Save(Object)	將所提供的物件樹處理成 XAML 節點表示，並回傳輸出 XAML 的字串表示。
Save(Stream, Object)	將所提供的物件圖處理成 XAML 節點表示，然後再轉為輸出串流進行序列化。
Save(TextWriter, Object)	將所提供的物件圖處理成 XAML 節點表示，再輸出至所提供的 TextWriter。
Save(String, Object)	將所提供的物件圖處理成 XAML 節點表示，然後將其寫入指定位置的輸出檔案。
Save(XamlWriter, Object)	將所提供的物件圖處理成 XAML 節點表示，然後寫入所提供的 XAML 寫入器。
Save(XmlWriter, Object)	將所提供的物件圖處理成 XAML 節點表示，然後寫入所提供的 XmlWriter。

Save(Object)

將所提供的物件樹處理成 XAML 節點表示，並回傳輸出 XAML 的字串表示。

public:
 static System::String ^ Save(System::Object ^ instance);

public static string Save(object instance);

static member Save : obj -> string

Public Shared Function Save (instance As Object) As String

參數

instance: Object

物件圖的根節點。

傳回

String

XAML 標記輸出為字串。

備註

此方法的輸出是 ToString 由方法呼叫所產生的的結果 XmlWriter 。這是 XmlWriter 透過以下設定建立的： XmlWriterSettings.Indent 是 true;且 XmlWriterSettings.OmitXmlDeclaration 是 true。

如果你將回傳字串處理成串流，或是專門用於 XAML 的讀取器，回傳的字串可以透過此 Create 方法載入為有效 XML。

適用於

Save(Stream, Object)

將所提供的物件圖處理成 XAML 節點表示，然後再轉為輸出串流進行序列化。

public:
 static void Save(System::IO::Stream ^ stream, System::Object ^ instance);

public static void Save(System.IO.Stream stream, object instance);

static member Save : System.IO.Stream * obj -> unit

Public Shared Sub Save (stream As Stream, instance As Object)

參數

stream: Stream

目的地串流。

instance: Object

物件圖的根節點。

例外狀況

ArgumentNullException

stream 輸入為 null。

備註

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 特定概念，例如相依屬性的優化。

適用於

Save(TextWriter, Object)

將所提供的物件圖處理成 XAML 節點表示，再輸出至所提供的 TextWriter。

public:
 static void Save(System::IO::TextWriter ^ writer, System::Object ^ instance);

public static void Save(System.IO.TextWriter writer, object instance);

static member Save : System.IO.TextWriter * obj -> unit

Public Shared Sub Save (writer As TextWriter, instance As Object)

參數

writer: TextWriter

然後 TextWriter 寫出輸出。

instance: Object

物件圖的根節點。

例外狀況

ArgumentNullException

writer 輸入為 null。

適用於

Save(String, Object)

將所提供的物件圖處理成 XAML 節點表示，然後將其寫入指定位置的輸出檔案。

public:
 static void Save(System::String ^ fileName, System::Object ^ instance);

public static void Save(string fileName, object instance);

static member Save : string * obj -> unit

Public Shared Sub Save (fileName As String, instance As Object)

參數

fileName: String

寫入輸出的檔案名稱與位置。

instance: Object

物件圖的根節點。

例外狀況

ArgumentException

fileName 是空字串。

ArgumentNullException

fileName 是 null。

備註

fileName參數值作為outputFileName呼叫的輸入，該呼叫XmlWriter.Create會產生作為XmlWriter方法呼叫的一部分。

適用於

Save(XamlWriter, Object)

將所提供的物件圖處理成 XAML 節點表示，然後寫入所提供的 XAML 寫入器。

public:
 static void Save(System::Xaml::XamlWriter ^ writer, System::Object ^ instance);

public static void Save(System.Xaml.XamlWriter writer, object instance);

static member Save : System.Xaml.XamlWriter * obj -> unit

Public Shared Sub Save (writer As XamlWriter, instance As Object)

參數

writer: XamlWriter

XamlWriter實作方式。

instance: Object

物件圖的根節點。

例外狀況

ArgumentNullException

writer 輸入為 null。

備註

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

你自己定義 XamlWriter了 .
你指定了與預設不同的設定 XamlWriter 。

適用於

Save(XmlWriter, Object)

將所提供的物件圖處理成 XAML 節點表示，然後寫入所提供的 XmlWriter。

public:
 static void Save(System::Xml::XmlWriter ^ writer, System::Object ^ instance);

public static void Save(System.Xml.XmlWriter writer, object instance);

static member Save : System.Xml.XmlWriter * obj -> unit

Public Shared Sub Save (writer As XmlWriter, instance As Object)

參數

writer: XmlWriter

XmlWriter實作方式。

instance: Object

物件圖的根節點。

例外狀況

ArgumentNullException

writer 輸入為 null。

適用於

意見反應

此頁面對您有幫助嗎？