XamlWriter.Save Methode

Definition

Namespace:

System.Windows.Markup

Assembly:

PresentationFramework.dll

Gibt XAML direkt oder über einen Objektvermittler zurück, mit dem das angegebene Objekt serialisiert wird.

Überlädt

Save(Object)	Gibt eine XAML-Zeichenfolge zurück, die das angegebene Objekt und seine Eigenschaften serialisiert.
Save(Object, Stream)	Speichert XAML-Informationen in einen angegebenen Stream, um das angegebene Objekt und seine Eigenschaften zu serialisieren.
Save(Object, TextWriter)	Speichert XAML-Informationen als Quelle für ein bereitgestelltes TextWriter-Objekt. Anhand der Ausgabe des TextWriter können dann das bereitgestellte Objekt und seine Eigenschaften serialisiert werden.
Save(Object, XamlDesignerSerializationManager)	Speichert XAML-Informationen in einem benutzerdefinierten Serialisierungsprogramm. Anhand der Ausgabe des Serialisierers können dann das bereitgestellte Objekt und seine Eigenschaften serialisiert werden.
Save(Object, XmlWriter)	Speichert XAML-Informationen als Quelle für ein bereitgestelltes XmlWriter-Objekt. Anhand der Ausgabe des XmlWriter können dann das bereitgestellte Objekt und seine Eigenschaften serialisiert werden.

Save(Object)

Gibt eine XAML-Zeichenfolge zurück, die das angegebene Objekt und seine Eigenschaften serialisiert.

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

Parameter

obj

Object

Das zu serialisierende Element. Es handelt sich i. d. R. um das Stammelement einer Seite oder Anwendung.

Gibt zurück

String

Eine XAML-Zeichenfolge, die in einen Stream oder eine Datei geschrieben werden kann. Die logische Struktur aller Elemente, die unter das bereitgestellte obj-Element fallen, wird serialisiert.

Ausnahmen

ArgumentNullException

obj ist null.

SecurityException

Die Anwendung wird nicht mit voller Vertrauenswürdigkeit ausgeführt.

Beispiele

Im folgenden Beispiel wird eine Button mithilfe der XamlWriter -Klasse in eine Zeichenfolge serialisiert. Die Zeichenfolge wird dann mithilfe der statischen Load Methode für die XamlReader -Klasse wieder in ein Button deserialisiert.

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

Hinweise

Die durch diese Methode aktivierte Serialisierung weist eine Reihe von Einschränkungen auf. Dies liegt daran, dass die aktivierte Serialisierung explizit zur Laufzeit ist und keinen Zugriff auf mögliche Entwurfszeitinformationen im ursprünglichen XAML hat (sofern vorhanden). Weitere Informationen finden Sie unter Serialisierungseinschränkungen von XamlWriter.Save.

Das Aufrufen Save ist bei teilweise vertrauenswürdiger Ausführung nicht zulässig.

Weitere Informationen

• XamlReader

Save(Object, Stream)

Speichert XAML-Informationen in einen angegebenen Stream, um das angegebene Objekt und seine Eigenschaften zu serialisieren.

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)

Parameter

obj

Object

Das zu serialisierende Element. Es handelt sich i. d. R. um das Stammelement einer Seite oder Anwendung.

stream

Stream

Der Zielstream für die serialisierten XAML-Informationen.

Ausnahmen

ArgumentNullException

obj oder stream ist null.

SecurityException

Die Anwendung wird nicht mit voller Vertrauenswürdigkeit ausgeführt.

Beispiele

Im folgenden Beispiel wird eine Button mithilfe der XamlWriter -Klasse in eine MemoryStream serialisiert. Der Stream wird dann mithilfe der statischen Load Methode für die XamlReader -Klasse wieder in ein Button deserialisiert.

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

Hinweise

Die durch diese Methode aktivierte Serialisierung weist eine Reihe von Einschränkungen auf. Dies liegt daran, dass die aktivierte Serialisierung explizit zur Laufzeit ist und keinen Zugriff auf mögliche Entwurfszeitinformationen im ursprünglichen XAML hat (sofern vorhanden). Weitere Informationen finden Sie unter Serialisierungseinschränkungen von XamlWriter.Save.

Das Aufrufen Save ist bei teilweise vertrauenswürdiger Ausführung nicht zulässig.

Weitere Informationen

• XamlReader

Save(Object, TextWriter)

Speichert XAML-Informationen als Quelle für ein bereitgestelltes TextWriter-Objekt. Anhand der Ausgabe des TextWriter können dann das bereitgestellte Objekt und seine Eigenschaften serialisiert werden.

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)

Parameter

obj

Object

Das zu serialisierende Element. Es handelt sich i. d. R. um das Stammelement einer Seite oder Anwendung.

writer

TextWriter

Eine TextWriter-Instanz als Ziel für das Schreiben der serialisierten XAML-Informationen.

Ausnahmen

ArgumentNullException

obj oder writer ist null.

SecurityException

Die Anwendung wird nicht mit voller Vertrauenswürdigkeit ausgeführt.

Hinweise

Die durch diese Methode aktivierte Serialisierung weist eine Reihe von Einschränkungen auf. Dies liegt daran, dass die aktivierte Serialisierung explizit zur Laufzeit ist und keinen Zugriff auf mögliche Entwurfszeitinformationen im ursprünglichen XAML hat (sofern vorhanden). Weitere Informationen finden Sie unter Serialisierungseinschränkungen von XamlWriter.Save.

Das Aufrufen Save ist bei teilweise vertrauenswürdiger Ausführung nicht zulässig.

Weitere Informationen

• XamlReader

Save(Object, XamlDesignerSerializationManager)

Speichert XAML-Informationen in einem benutzerdefinierten Serialisierungsprogramm. Anhand der Ausgabe des Serialisierers können dann das bereitgestellte Objekt und seine Eigenschaften serialisiert werden.

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)

Parameter

obj

Object

Das zu serialisierende Element. Es handelt sich i. d. R. um das Stammelement einer Seite oder Anwendung.

manager

XamlDesignerSerializationManager

Eine benutzerdefinierte Serialisierungsimplementierung.

Ausnahmen

ArgumentNullException

obj oder manager ist null.

SecurityException

Die Anwendung wird nicht mit voller Vertrauenswürdigkeit ausgeführt.

Hinweise

Die durch diese Methode aktivierte Serialisierung weist eine Reihe von Einschränkungen auf. Dies liegt daran, dass die aktivierte Serialisierung explizit zur Laufzeit ist und keinen Zugriff auf mögliche Entwurfszeitinformationen im ursprünglichen XAML hat (sofern vorhanden). Weitere Informationen finden Sie unter Serialisierungseinschränkungen von XamlWriter.Save.

Das Aufrufen Save ist bei teilweise vertrauenswürdiger Ausführung nicht zulässig.

Weitere Informationen

• XamlReader

Save(Object, XmlWriter)

Speichert XAML-Informationen als Quelle für ein bereitgestelltes XmlWriter-Objekt. Anhand der Ausgabe des XmlWriter können dann das bereitgestellte Objekt und seine Eigenschaften serialisiert werden.

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)

Parameter

obj

Object

Das zu serialisierende Element. Es handelt sich i. d. R. um das Stammelement einer Seite oder Anwendung.

xmlWriter

XmlWriter

Der Writer, mit dem die serialisierten XAML-Informationen geschrieben werden sollen.

Ausnahmen

ArgumentNullException

obj oder xmlWriter ist null.

SecurityException

Die Anwendung wird nicht mit voller Vertrauenswürdigkeit ausgeführt.

Hinweise

Die durch diese Methode aktivierte Serialisierung weist eine Reihe von Einschränkungen auf. Dies liegt daran, dass die aktivierte Serialisierung explizit zur Laufzeit ist und keinen Zugriff auf mögliche Entwurfszeitinformationen im ursprünglichen XAML hat (sofern vorhanden). Weitere Informationen finden Sie unter Serialisierungseinschränkungen von XamlWriter.Save.

Das Aufrufen Save ist bei teilweise vertrauenswürdiger Ausführung nicht zulässig.

Weitere Informationen

• XamlReader