XamlWriter Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides a single static Save method (multiple overloads) that can be used for limited XAML serialization of provided run-time objects into XAML markup.
public ref class XamlWriter abstract sealed
public static class XamlWriter
type XamlWriter = class
Public Class XamlWriter
- Inheritance
-
XamlWriter
Examples
The following example serializes a Button into a string using the XamlWriter class. 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)
Remarks
The serialization enabled by this method has a series of limitations. 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). For details, see Serialization Limitations of XamlWriter.Save.
Calling Save is not permitted when running in partial trust. This includes from XBAPs.
Methods
Save(Object) |
Returns a XAML string that serializes the specified object and its properties. |
Save(Object, Stream) |
Saves XAML information into a specified stream to serialize the specified object and its properties. |
Save(Object, TextWriter) |
Saves XAML information as the source for a provided TextWriter object. The output of the TextWriter can then be used to serialize the provided object and its properties. |
Save(Object, XamlDesignerSerializationManager) |
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) |
Saves XAML information as the source for a provided XmlWriter object. The output of the XmlWriter can then be used to serialize the provided object and its properties. |