XamlWriter.Save Método

Definición

Espacio de nombres:

System.Windows.Markup

Ensamblado:

PresentationFramework.dll

Devuelve el XAML directamente o a través de un intermediario que serializa el objeto especificado.

Sobrecargas

Save(Object)	Devuelve una cadena XAML que serializa el objeto especificado y sus propiedades.
Save(Object, Stream)	Guarda la información XAML en la secuencia especificada para serializar el objeto especificado y sus propiedades.
Save(Object, TextWriter)	Guarda la información XAML como origen del objeto TextWriter proporcionado. A continuación, la salida de TextWriter puede usarse para serializar el objeto proporcionado y sus propiedades.
Save(Object, XamlDesignerSerializationManager)	Guarda la información XAML en un serializador personalizado. El resultado del serializador se puede utilizar a continuación para serializar el objeto proporcionado y sus propiedades.
Save(Object, XmlWriter)	Guarda la información XAML como origen del objeto XmlWriter proporcionado. A continuación, la salida de XmlWriter puede usarse para serializar el objeto proporcionado y sus propiedades.

Save(Object)

Devuelve una cadena XAML que serializa el objeto especificado y sus propiedades.

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

Parámetros

obj

Object

Elemento que se va a serializar. Normalmente, se trata del elemento raíz de una página o aplicación.

Devoluciones

String

Cadena XAML que se puede escribir en una secuencia o un archivo. Se va a serializar el árbol lógico de todos los elementos que forman parte del elemento obj proporcionado.

Excepciones

ArgumentNullException

obj es null.

SecurityException

La aplicación no se ejecuta en plena confianza.

Ejemplos

En el ejemplo siguiente se serializa en Button una cadena mediante la XamlWriter clase . A continuación, la cadena se deserializa en un Button mediante el método estático Load en la XamlReader clase .

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

Comentarios

La serialización habilitada por este método tiene una serie de limitaciones. Esto se debe a que la serialización habilitada es explícitamente en tiempo de ejecución y no tiene acceso a la información en tiempo de diseño posible en el XAML original (si existe). Para obtener más información, consulta Limitaciones de serialización de XamlWriter.Save.

No se permite llamar Save a cuando se ejecuta en confianza parcial.

Consulte también

• XamlReader

Save(Object, Stream)

Guarda la información XAML en la secuencia especificada para serializar el objeto especificado y sus propiedades.

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)

Parámetros

obj

Object

Elemento que se va a serializar. Normalmente, se trata del elemento raíz de una página o aplicación.

stream

Stream

Secuencia de destino de la información XAML serializada.

Excepciones

ArgumentNullException

obj o stream es null.

SecurityException

La aplicación no se ejecuta en plena confianza.

Ejemplos

En el ejemplo siguiente se serializa un Button objeto en un MemoryStream mediante la XamlWriter clase . A continuación, la secuencia se deserializa en un Button mediante el método estático Load en la XamlReader clase .

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

Comentarios

La serialización habilitada por este método tiene una serie de limitaciones. Esto se debe a que la serialización habilitada es explícitamente en tiempo de ejecución y no tiene acceso a la información en tiempo de diseño posible en el XAML original (si existe). Para obtener más información, consulta Limitaciones de serialización de XamlWriter.Save.

No se permite llamar Save a cuando se ejecuta en confianza parcial.

Consulte también

• XamlReader

Save(Object, TextWriter)

Guarda la información XAML como origen del objeto TextWriter proporcionado. A continuación, la salida de TextWriter puede usarse para serializar el objeto proporcionado y sus propiedades.

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)

Parámetros

obj

Object

Elemento que se va a serializar. Normalmente, se trata del elemento raíz de una página o aplicación.

writer

TextWriter

Instancia de TextWriter como destino donde se escribe la información XAML serializada.

Excepciones

ArgumentNullException

obj o writer es null.

SecurityException

La aplicación no se ejecuta en plena confianza.

Comentarios

La serialización habilitada por este método tiene una serie de limitaciones. Esto se debe a que la serialización habilitada es explícitamente en tiempo de ejecución y no tiene acceso a la información en tiempo de diseño posible en el XAML original (si existe). Para obtener más información, consulta Limitaciones de serialización de XamlWriter.Save.

No se permite llamar Save a cuando se ejecuta en confianza parcial.

Consulte también

• XamlReader

Save(Object, XamlDesignerSerializationManager)

Guarda la información XAML en un serializador personalizado. El resultado del serializador se puede utilizar a continuación para serializar el objeto proporcionado y sus propiedades.

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)

Parámetros

obj

Object

Elemento que se va a serializar. Normalmente, se trata del elemento raíz de una página o aplicación.

manager

XamlDesignerSerializationManager

Implementación de serialización personalizada.

Excepciones

ArgumentNullException

obj o manager es null.

SecurityException

La aplicación no se ejecuta en plena confianza.

Comentarios

La serialización habilitada por este método tiene una serie de limitaciones. Esto se debe a que la serialización habilitada es explícitamente en tiempo de ejecución y no tiene acceso a la información en tiempo de diseño posible en el XAML original (si existe). Para obtener más información, consulta Limitaciones de serialización de XamlWriter.Save.

No se permite llamar Save a cuando se ejecuta en confianza parcial.

Consulte también

• XamlReader

Save(Object, XmlWriter)

Guarda la información XAML como origen del objeto XmlWriter proporcionado. A continuación, la salida de XmlWriter puede usarse para serializar el objeto proporcionado y sus propiedades.

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)

Parámetros

obj

Object

Elemento que se va a serializar. Normalmente, se trata del elemento raíz de una página o aplicación.

xmlWriter

XmlWriter

Sistema de escritura que se va a utilizar para escribir la información XAML serializada.

Excepciones

ArgumentNullException

obj o xmlWriter es null.

SecurityException

La aplicación no se ejecuta en plena confianza.

Comentarios

La serialización habilitada por este método tiene una serie de limitaciones. Esto se debe a que la serialización habilitada es explícitamente en tiempo de ejecución y no tiene acceso a la información en tiempo de diseño posible en el XAML original (si existe). Para obtener más información, consulta Limitaciones de serialización de XamlWriter.Save.

No se permite llamar Save a cuando se ejecuta en confianza parcial.

Consulte también

• XamlReader