XamlWriter.Save Método

Referência

Definição

Namespace:: System.Windows.Markup

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna o XAML diretamente ou por meio de um objeto intermediário que serializa o objeto especificado.

Sobrecargas

Save(Object)	Retorna uma cadeia de caracteres XAML que serializa o objeto especificado e suas propriedades.
Save(Object, Stream)	Salva as informações sobre XAML em um fluxo especificado para serializar o objeto especificado e suas propriedades.
Save(Object, TextWriter)	Salva informações XAML como a origem de um objeto fornecido TextWriter. A saída de TextWriter pode ser usada para serializar o objeto fornecido e suas propriedades.
Save(Object, XamlDesignerSerializationManager)	Salva informações XAML em um serializador personalizado. Em seguida, a saída do serializador poderá ser usada para serializar o objeto fornecido e suas propriedades.
Save(Object, XmlWriter)	Salva informações XAML como a origem de um objeto fornecido XmlWriter. A saída de XmlWriter pode ser usada para serializar o objeto fornecido e suas propriedades.

Save(Object)

Retorna uma cadeia de caracteres XAML que serializa o objeto especificado e suas propriedades.

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

O elemento a ser serializado. Normalmente, esse é o elemento raiz de uma página ou de um aplicativo.

Retornos

String

Uma cadeia de caracteres XAML que pode ser gravada em um fluxo ou arquivo. A árvore lógica de todos os elementos que se enquadram no elemento obj fornecido será serializado.

Exceções

ArgumentNullException

obj é null.

SecurityException

O aplicativo não está sendo executado em confiança total.

Exemplos

O exemplo a seguir serializa um Button em uma cadeia de caracteres usando a XamlWriter classe . Em seguida, a cadeia de caracteres é desserializada de volta em um Button usando o método estático Load na XamlReader classe .

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

Comentários

A serialização habilitada por esse método tem uma série de limitações. Isso ocorre porque a serialização habilitada é explicitamente em tempo de execução e não tem acesso a possíveis informações de tempo de design no XAML original (se houver). Para obter detalhes, consulte Limitações de serialização de XamlWriter.Save.

A chamada Save não é permitida durante a execução em confiança parcial.

Confira também

XamlReader

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Save(Object, Stream)

Salva as informações sobre XAML em um fluxo especificado para serializar o objeto especificado e suas propriedades.

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

O elemento a ser serializado. Normalmente, esse é o elemento raiz de uma página ou de um aplicativo.

stream: Stream

Fluxo de destino para as informações sobre XAML serializadas.

Exceções

ArgumentNullException

obj ou stream é null.

SecurityException

O aplicativo não está sendo executado em confiança total.

Exemplos

O exemplo a seguir serializa um Button em um MemoryStream usando a XamlWriter classe . Em seguida, o fluxo é desserializado de volta em um Button usando o método estático Load na XamlReader classe .

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

Comentários

A chamada Save não é permitida durante a execução em confiança parcial.

Confira também

XamlReader

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Save(Object, TextWriter)

Salva informações XAML como a origem de um objeto fornecido TextWriter. A saída de TextWriter pode ser usada para serializar o objeto fornecido e suas propriedades.

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

O elemento a ser serializado. Normalmente, esse é o elemento raiz de uma página ou de um aplicativo.

writer: TextWriter

Uma instância de TextWriter como o destino em que as informações XAML serializadas são gravadas.

Exceções

ArgumentNullException

obj ou writer é null.

SecurityException

O aplicativo não está sendo executado em confiança total.

Comentários

A chamada Save não é permitida durante a execução em confiança parcial.

Confira também

XamlReader

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Save(Object, XamlDesignerSerializationManager)

Salva informações XAML em um serializador personalizado. Em seguida, a saída do serializador poderá ser usada para serializar o objeto fornecido e suas propriedades.

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

O elemento a ser serializado. Normalmente, esse é o elemento raiz de uma página ou de um aplicativo.

manager: XamlDesignerSerializationManager

Uma implementação de serialização personalizada.

Exceções

ArgumentNullException

obj ou manager é null.

SecurityException

O aplicativo não está sendo executado em confiança total.

Comentários

A chamada Save não é permitida durante a execução em confiança parcial.

Confira também

XamlReader

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Save(Object, XmlWriter)

Salva informações XAML como a origem de um objeto fornecido XmlWriter. A saída de XmlWriter pode ser usada para serializar o objeto fornecido e suas propriedades.

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

O elemento a ser serializado. Normalmente, esse é o elemento raiz de uma página ou de um aplicativo.

xmlWriter: XmlWriter

Gravador a ser usado para gravar as informações XAML serializadas.

Exceções

ArgumentNullException

obj ou xmlWriter é null.

SecurityException

O aplicativo não está sendo executado em confiança total.

Comentários

A chamada Save não é permitida durante a execução em confiança parcial.

Confira também

XamlReader

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Partilhar via

XamlWriter.Save Método

Definição

Sobrecargas

Save(Object)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Save(Object, Stream)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Save(Object, TextWriter)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Save(Object, XamlDesignerSerializationManager)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Save(Object, XmlWriter)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais