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 标记输出。

注解

此方法的输出是由 ToStringXmlWriter 方法调用创建的 的结果。 它是 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.

注解

重要

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.