XamlWriter.Save Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> stringPublic Shared Function Save (obj As Object) As StringParameter
- obj
- Object
Das zu serialisierende Element. Es handelt sich i. d. R. um das Stammelement einer Seite oder Anwendung.
Gibt zurück
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
obj ist null.
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
Gilt für:
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 -> unitPublic 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
obj oder stream ist null.
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
Gilt für:
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 -> unitPublic 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
obj oder writer ist null.
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
Gilt für:
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 -> unitPublic 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
obj oder manager ist null.
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
Gilt für:
Save(Object, XmlWriter)
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 -> unitPublic 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
obj oder xmlWriter ist null.
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.
