XamlServices.Save 方法

定義

命名空間:

System.Xaml

組件:

System.Xaml.dll

將提供的物件圖形處理成 XAML 節點表示，再處理成序列化的輸出格式。

多載

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 標記輸出。

備註

這個方法的 XmlWriter 輸出是由 ToString 方法呼叫所建立的 結果。 這是 XmlWriter 使用下列設定所建立：是 XmlWriterSettings.Indenttrue ，而 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。

備註

重要

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

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。