XamlWriter.Save 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
直接或通过序列化指定对象的对象中介返回 XAML。
重载
| 名称 | 说明 |
|---|---|
| Save(Object) |
返回一个 XAML 字符串,该字符串序列化指定的对象及其属性。 |
| Save(Object, Stream) |
将 XAML 信息保存到指定的流中,以序列化指定的对象及其属性。 |
| Save(Object, TextWriter) |
将 XAML 信息保存为提供的 TextWriter 对象的源。 TextWriter然后,可以使用输出来序列化所提供的对象及其属性。 |
| Save(Object, XamlDesignerSerializationManager) |
将 XAML 信息保存到自定义序列化程序。 然后,序列化程序的输出可用于序列化所提供的对象及其属性。 |
| Save(Object, XmlWriter) |
将 XAML 信息保存为提供的 XmlWriter 对象的源。 XmlWriter然后,可以使用输出来序列化所提供的对象及其属性。 |
Save(Object)
返回一个 XAML 字符串,该字符串序列化指定的对象及其属性。
public:
static System::String ^ Save(System::Object ^ obj);
public static string Save(object obj);
static member Save : obj -> string
Public Shared Function Save (obj As Object) As String
参数
- obj
- Object
要序列化的元素。 通常,这是页面或应用程序的根元素。
返回
可以写入流或文件的 XAML 字符串。 将序列化属于所提供 obj 元素下的所有元素的逻辑树。
例外
obj 是 null。
应用程序未完全信任运行。
示例
以下示例使用Button类将 a XamlWriter 序列化为字符串。 然后,该字符串将反序列化回Button类上使用Load静态XamlReader方法。
// Create the Button.
Button originalButton = new Button();
originalButton.Height = 50;
originalButton.Width = 100;
originalButton.Background = Brushes.AliceBlue;
originalButton.Content = "Click Me";
// Save the Button to a string.
string savedButton = XamlWriter.Save(originalButton);
// Load the button
StringReader stringReader = new StringReader(savedButton);
XmlReader xmlReader = XmlReader.Create(stringReader);
Button readerLoadButton = (Button)XamlReader.Load(xmlReader);
' Create the Button.
Dim originalButton As New Button()
originalButton.Height = 50
originalButton.Width = 100
originalButton.Background = Brushes.AliceBlue
originalButton.Content = "Click Me"
' Save the Button to a string.
Dim savedButton As String = XamlWriter.Save(originalButton)
' Load the button
Dim stringReader As New StringReader(savedButton)
Dim xmlReader As XmlReader = XmlReader.Create(stringReader)
Dim readerLoadButton As Button = CType(XamlReader.Load(xmlReader), Button)
注解
此方法启用的序列化具有一系列限制。 这是因为启用序列化是显式运行时,并且无权访问原始 XAML 中可能的设计时信息(如果有)。 有关详细信息,请参阅 XamlWriter.Save 的序列化限制。
在部分信任中运行时,不允许调用 Save 。
另请参阅
适用于
Save(Object, Stream)
将 XAML 信息保存到指定的流中,以序列化指定的对象及其属性。
public:
static void Save(System::Object ^ obj, System::IO::Stream ^ stream);
public static void Save(object obj, System.IO.Stream stream);
static member Save : obj * System.IO.Stream -> unit
Public Shared Sub Save (obj As Object, stream As Stream)
参数
- obj
- Object
要序列化的元素。 通常,这是页面或应用程序的根元素。
- stream
- Stream
序列化 XAML 信息的目标流。
例外
obj 或 stream 为 null.
应用程序未完全信任运行。
示例
以下示例将 a Button 序列化为 MemoryStream 使用 XamlWriter 类。 然后,该流将反序列化回Button类上使用Load静态XamlReader方法。
// Create the Button.
Button originalButton = new Button();
originalButton.Height = 50;
originalButton.Width = 100;
originalButton.Background = Brushes.AliceBlue;
originalButton.Content = "Click Me";
// Save the Button to a string.
string savedButton = XamlWriter.Save(originalButton);
// Load the button
StringReader stringReader = new StringReader(savedButton);
XmlReader xmlReader = XmlReader.Create(stringReader);
Button readerLoadButton = (Button)XamlReader.Load(xmlReader);
' Create the Button.
Dim originalButton As New Button()
originalButton.Height = 50
originalButton.Width = 100
originalButton.Background = Brushes.AliceBlue
originalButton.Content = "Click Me"
' Save the Button to a string.
Dim savedButton As String = XamlWriter.Save(originalButton)
' Load the button
Dim stringReader As New StringReader(savedButton)
Dim xmlReader As XmlReader = XmlReader.Create(stringReader)
Dim readerLoadButton As Button = CType(XamlReader.Load(xmlReader), Button)
注解
此方法启用的序列化具有一系列限制。 这是因为启用序列化是显式运行时,并且无权访问原始 XAML 中可能的设计时信息(如果有)。 有关详细信息,请参阅 XamlWriter.Save 的序列化限制。
在部分信任中运行时,不允许调用 Save 。
另请参阅
适用于
Save(Object, TextWriter)
将 XAML 信息保存为提供的 TextWriter 对象的源。 TextWriter然后,可以使用输出来序列化所提供的对象及其属性。
public:
static void Save(System::Object ^ obj, System::IO::TextWriter ^ writer);
public static void Save(object obj, System.IO.TextWriter writer);
static member Save : obj * System.IO.TextWriter -> unit
Public Shared Sub Save (obj As Object, writer As TextWriter)
参数
- obj
- Object
要序列化的元素。 通常,这是页面或应用程序的根元素。
- writer
- TextWriter
作为 TextWriter 写入序列化 XAML 信息的目标的实例。
例外
obj 或 writer 为 null.
应用程序未完全信任运行。
注解
此方法启用的序列化具有一系列限制。 这是因为启用序列化是显式运行时,并且无权访问原始 XAML 中可能的设计时信息(如果有)。 有关详细信息,请参阅 XamlWriter.Save 的序列化限制。
在部分信任中运行时,不允许调用 Save 。
另请参阅
适用于
Save(Object, XamlDesignerSerializationManager)
将 XAML 信息保存到自定义序列化程序。 然后,序列化程序的输出可用于序列化所提供的对象及其属性。
public:
static void Save(System::Object ^ obj, System::Windows::Markup::XamlDesignerSerializationManager ^ manager);
public static void Save(object obj, System.Windows.Markup.XamlDesignerSerializationManager manager);
static member Save : obj * System.Windows.Markup.XamlDesignerSerializationManager -> unit
Public Shared Sub Save (obj As Object, manager As XamlDesignerSerializationManager)
参数
- obj
- Object
要序列化的元素。 通常,这是页面或应用程序的根元素。
- manager
- XamlDesignerSerializationManager
自定义序列化实现。
例外
obj 或 manager 为 null.
应用程序未完全信任运行。
注解
此方法启用的序列化具有一系列限制。 这是因为启用序列化是显式运行时,并且无权访问原始 XAML 中可能的设计时信息(如果有)。 有关详细信息,请参阅 XamlWriter.Save 的序列化限制。
在部分信任中运行时,不允许调用 Save 。
另请参阅
适用于
Save(Object, XmlWriter)
public:
static void Save(System::Object ^ obj, System::Xml::XmlWriter ^ xmlWriter);
public static void Save(object obj, System.Xml.XmlWriter xmlWriter);
static member Save : obj * System.Xml.XmlWriter -> unit
Public Shared Sub Save (obj As Object, xmlWriter As XmlWriter)
参数
- obj
- Object
要序列化的元素。 通常,这是页面或应用程序的根元素。
- xmlWriter
- XmlWriter
用于写入序列化 XAML 信息的编写器。
例外
obj 或 xmlWriter 为 null.
应用程序未完全信任运行。
注解
此方法启用的序列化具有一系列限制。 这是因为启用序列化是显式运行时,并且无权访问原始 XAML 中可能的设计时信息(如果有)。 有关详细信息,请参阅 XamlWriter.Save 的序列化限制。
在部分信任中运行时,不允许调用 Save 。