XamlWriter.Save Метод

Определение

Возвращает XAML напрямую либо через промежуточный объект, который сериализует указанный объект.Returns XAML either directly or through an object intermediary that serializes the specified object.

Перегрузки

Save(Object)

Возвращает строку XAML, которая сериализует указанный объект и его свойства.Returns a XAML string that serializes the specified object and its properties.

Save(Object, Stream)

Сохраняет информацию XAML в указанном потоке для сериализации указанного объекта и его свойств.Saves XAML information into a specified stream to serialize the specified object and its properties.

Save(Object, TextWriter)

Сохраняет информацию XAML как источник для предоставленного объекта TextWriter.Saves XAML information as the source for a provided TextWriter object. Вывод объекта TextWriter может затем использоваться для сериализации предоставленного объекта и его свойств.The output of the TextWriter can then be used to serialize the provided object and its properties.

Save(Object, XamlDesignerSerializationManager)

Сохраняет информацию XAML в пользовательском сериализаторе.Saves XAML information into a custom serializer. Вывод этого сериализатора может затем использоваться для сериализации предоставленного объекта и его свойств.The output of the serializer can then be used to serialize the provided object and its properties.

Save(Object, XmlWriter)

Сохраняет информацию XAML как источник для предоставленного объекта XmlWriter.Saves XAML information as the source for a provided XmlWriter object. Вывод объекта XmlWriter может затем использоваться для сериализации предоставленного объекта и его свойств.The output of the XmlWriter can then be used to serialize the provided object and its properties.

Save(Object)

Возвращает строку XAML, которая сериализует указанный объект и его свойства.Returns a XAML string that serializes the specified object and its properties.

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

Сериализуемый элемент.The element to be serialized. Обычно это корневой элемент страницы или приложения.Typically, this is the root element of a page or application.

Возвращаемое значение

String

Строка XAML, которая может быть записана в поток или файл.A XAML string that can be written to a stream or file. Логическое дерево элементов, находящихся под предоставленным элементом obj, будет сериализовано.The logical tree of all elements that fall under the provided obj element will be serialized.

Исключения

obj имеет значение null.obj is null.

Приложение не выполняется с полным доверием.The application is not running in full trust.

Примеры

В следующем примере выполняется сериализация в Button строку с помощью XamlWriter класса.The following example serializes a Button into a string using the XamlWriter class. Затем строка десериализуется обратно в объект Button с использованием статического Load метода XamlReader класса.The string is then deserialized back into a Button using the static Load method on the XamlReader class.

// 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)

Комментарии

Сериализация, включенная этим методом, имеет ряд ограничений.The serialization enabled by this method has a series of limitations. Это обусловлено тем, что сериализация включена явно и не имеет доступа к возможным сведениям времени разработки в исходном XAML (если таковой имеется).This is because the serialization enabled is explicitly run-time, and does not have access to possible design-time information in the original XAML (if any). Дополнительные сведения см. в разделе ограничения сериализации XamlWriter. Save.For details, see Serialization Limitations of XamlWriter.Save.

Вызов Save не разрешен при выполнении в режиме частичного доверия.Calling Save is not permitted when running in partial trust.

См. также раздел

Применяется к

Save(Object, Stream)

Сохраняет информацию XAML в указанном потоке для сериализации указанного объекта и его свойств.Saves XAML information into a specified stream to serialize the specified object and its properties.

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

Сериализуемый элемент.The element to be serialized. Обычно это корневой элемент страницы или приложения.Typically, this is the root element of a page or application.

stream
Stream

Поток назначения для сериализованной информации XAML.Destination stream for the serialized XAML information.

Исключения

Параметр obj или stream имеет значение null.obj or stream is null.

Приложение не выполняется с полным доверием.The application is not running in full trust.

Примеры

В следующем примере выполняется сериализация в с Button MemoryStream помощью XamlWriter класса.The following example serializes a Button into a MemoryStream using the XamlWriter class. Затем поток десериализуется обратно в объект, Button используя статический Load метод XamlReader класса.The stream is then deserialized back into a Button using the static Load method on the XamlReader class.

// 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)

Комментарии

Сериализация, включенная этим методом, имеет ряд ограничений.The serialization enabled by this method has a series of limitations. Это обусловлено тем, что сериализация включена явно и не имеет доступа к возможным сведениям времени разработки в исходном XAML (если таковой имеется).This is because the serialization enabled is explicitly run-time, and does not have access to possible design-time information in the original XAML (if any). Дополнительные сведения см. в разделе ограничения сериализации XamlWriter. Save.For details, see Serialization Limitations of XamlWriter.Save.

Вызов Save не разрешен при выполнении в режиме частичного доверия.Calling Save is not permitted when running in partial trust.

См. также раздел

Применяется к

Save(Object, TextWriter)

Сохраняет информацию XAML как источник для предоставленного объекта TextWriter.Saves XAML information as the source for a provided TextWriter object. Вывод объекта TextWriter может затем использоваться для сериализации предоставленного объекта и его свойств.The output of the TextWriter can then be used to serialize the provided object and its properties.

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

Сериализуемый элемент.The element to be serialized. Обычно это корневой элемент страницы или приложения.Typically, this is the root element of a page or application.

writer
TextWriter

Экземпляр объекта TextWriter как назначения, куда записывается сериализованная информация XAML.A TextWriter instance as the destination where the serialized XAML information is written.

Исключения

Параметр obj или writer имеет значение null.obj or writer is null.

Приложение не выполняется с полным доверием.The application is not running in full trust.

Комментарии

Сериализация, включенная этим методом, имеет ряд ограничений.The serialization enabled by this method has a series of limitations. Это обусловлено тем, что сериализация включена явно и не имеет доступа к возможным сведениям времени разработки в исходном XAML (если таковой имеется).This is because the serialization enabled is explicitly run-time, and does not have access to possible design-time information in the original XAML (if any). Дополнительные сведения см. в разделе ограничения сериализации XamlWriter. Save.For details, see Serialization Limitations of XamlWriter.Save.

Вызов Save не разрешен при выполнении в режиме частичного доверия.Calling Save is not permitted when running in partial trust.

См. также раздел

Применяется к

Save(Object, XamlDesignerSerializationManager)

Сохраняет информацию XAML в пользовательском сериализаторе.Saves XAML information into a custom serializer. Вывод этого сериализатора может затем использоваться для сериализации предоставленного объекта и его свойств.The output of the serializer can then be used to serialize the provided object and its properties.

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

Сериализуемый элемент.The element to be serialized. Обычно это корневой элемент страницы или приложения.Typically, this is the root element of a page or application.

manager
XamlDesignerSerializationManager

Пользовательская реализация сериализации.A custom serialization implementation.

Исключения

Параметр obj или manager имеет значение null.obj or manager is null.

Приложение не выполняется с полным доверием.The application is not running in full trust.

Комментарии

Сериализация, включенная этим методом, имеет ряд ограничений.The serialization enabled by this method has a series of limitations. Это обусловлено тем, что сериализация включена явно и не имеет доступа к возможным сведениям времени разработки в исходном XAML (если таковой имеется).This is because the serialization enabled is explicitly run-time, and does not have access to possible design-time information in the original XAML (if any). Дополнительные сведения см. в разделе ограничения сериализации XamlWriter. Save.For details, see Serialization Limitations of XamlWriter.Save.

Вызов Save не разрешен при выполнении в режиме частичного доверия.Calling Save is not permitted when running in partial trust.

См. также раздел

Применяется к

Save(Object, XmlWriter)

Сохраняет информацию XAML как источник для предоставленного объекта XmlWriter.Saves XAML information as the source for a provided XmlWriter object. Вывод объекта XmlWriter может затем использоваться для сериализации предоставленного объекта и его свойств.The output of the XmlWriter can then be used to serialize the provided object and its properties.

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

Сериализуемый элемент.The element to be serialized. Обычно это корневой элемент страницы или приложения.Typically, this is the root element of a page or application.

xmlWriter
XmlWriter

Модуль записи сериализованной информации XAML.Writer to use to write the serialized XAML information.

Исключения

Параметр obj или xmlWriter имеет значение null.obj or xmlWriter is null.

Приложение не выполняется с полным доверием.The application is not running in full trust.

Комментарии

Сериализация, включенная этим методом, имеет ряд ограничений.The serialization enabled by this method has a series of limitations. Это обусловлено тем, что сериализация включена явно и не имеет доступа к возможным сведениям времени разработки в исходном XAML (если таковой имеется).This is because the serialization enabled is explicitly run-time, and does not have access to possible design-time information in the original XAML (if any). Дополнительные сведения см. в разделе ограничения сериализации XamlWriter. Save.For details, see Serialization Limitations of XamlWriter.Save.

Вызов Save не разрешен при выполнении в режиме частичного доверия.Calling Save is not permitted when running in partial trust.

См. также раздел

Применяется к