XamlWriter.Save Methode

Definition

Namespace:: System.Windows.Markup

Assembly:: PresentationFramework.dll

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 entweder direkt oder über einen Objektvermittler zurück, der das angegebene Objekt serialisiert.

Überlädt

Name	Beschreibung
Save(Object)	Gibt eine XAML-Zeichenfolge zurück, die das angegebene Objekt und seine Eigenschaften serialisiert.
Save(Object, Stream)	Speichert XAML-Informationen in einem angegebenen Datenstrom, um das angegebene Objekt und dessen Eigenschaften zu serialisieren.
Save(Object, TextWriter)	Speichert XAML-Informationen als Quelle für ein bereitgestelltes TextWriter Objekt. Die Ausgabe des TextWriter Objekts kann dann verwendet werden, um das bereitgestellte Objekt und dessen Eigenschaften zu serialisieren.
Save(Object, XamlDesignerSerializationManager)	Speichert XAML-Informationen in einem benutzerdefinierten Serialisierer. Die Ausgabe des Serialisierers kann dann verwendet werden, um das bereitgestellte Objekt und seine Eigenschaften zu serialisieren.
Save(Object, XmlWriter)	Speichert XAML-Informationen als Quelle für ein bereitgestelltes XmlWriter Objekt. Die Ausgabe des XmlWriter Objekts kann dann verwendet werden, um das bereitgestellte Objekt und dessen Eigenschaften zu serialisieren.

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. In der Regel ist dies das Stammelement einer Seite oder Anwendung.

Gibt zurück

String

Eine XAML-Zeichenfolge, die in einen Datenstrom 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 voll vertrauenswürdig ausgeführt.

Beispiele

Im folgenden Beispiel wird eine Button in eine Zeichenfolge mithilfe der XamlWriter Klasse serialisiert. Die Zeichenfolge wird dann mithilfe der statischen Load Methode für die XamlReader Klasse wieder in eine 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 laufzeitbedingt ist und keinen Zugriff auf mögliche Entwurfszeitinformationen im ursprünglichen XAML -Code hat (falls vorhanden). Ausführliche Informationen finden Sie unter Serialisierungseinschränkungen von XamlWriter.Save.

Aufrufe Save sind nicht zulässig, wenn sie teilweise vertrauenswürdig ausgeführt werden.

Weitere Informationen

XamlReader

Gilt für:

Save(Object, Stream)

Speichert XAML-Informationen in einem angegebenen Datenstrom, um das angegebene Objekt und dessen 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. In der Regel ist dies das Stammelement einer Seite oder Anwendung.

stream: Stream

Zieldatenstrom für die serialisierten XAML-Informationen.

Ausnahmen

ArgumentNullException

obj oder stream ist null.

SecurityException

Die Anwendung wird nicht voll vertrauenswürdig ausgeführt.

Beispiele

Im folgenden Beispiel wird eine Button serialisiert in eine MemoryStream Using-Klasse XamlWriter . Der Datenstrom wird dann mithilfe der statischen Load Methode für die XamlReader Klasse wieder in eine 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

Aufrufe Save sind nicht zulässig, wenn sie teilweise vertrauenswürdig ausgeführt werden.

Weitere Informationen

XamlReader

Gilt für:

Save(Object, TextWriter)

Speichert XAML-Informationen als Quelle für ein bereitgestelltes TextWriter Objekt. Die Ausgabe des TextWriter Objekts kann dann verwendet werden, um das bereitgestellte Objekt und dessen Eigenschaften zu serialisieren.

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. In der Regel ist dies das Stammelement einer Seite oder Anwendung.

writer: TextWriter

Eine TextWriter Instanz als Ziel, an dem die serialisierten XAML-Informationen geschrieben werden.

Ausnahmen

ArgumentNullException

obj oder writer ist null.

SecurityException

Die Anwendung wird nicht voll vertrauenswürdig ausgeführt.

Hinweise

Aufrufe Save sind nicht zulässig, wenn sie teilweise vertrauenswürdig ausgeführt werden.

Weitere Informationen

XamlReader

Gilt für:

Save(Object, XamlDesignerSerializationManager)

Speichert XAML-Informationen in einem benutzerdefinierten Serialisierer. Die Ausgabe des Serialisierers kann dann verwendet werden, um das bereitgestellte Objekt und seine Eigenschaften zu serialisieren.

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. In der Regel ist dies das Stammelement einer Seite oder Anwendung.

manager: XamlDesignerSerializationManager

Eine benutzerdefinierte Serialisierungsimplementierung.

Ausnahmen

ArgumentNullException

obj oder manager ist null.

SecurityException

Die Anwendung wird nicht voll vertrauenswürdig ausgeführt.

Hinweise

Aufrufe Save sind nicht zulässig, wenn sie teilweise vertrauenswürdig ausgeführt werden.

Weitere Informationen

XamlReader

Gilt für:

Save(Object, XmlWriter)

Speichert XAML-Informationen als Quelle für ein bereitgestelltes XmlWriter Objekt. Die Ausgabe des XmlWriter Objekts kann dann verwendet werden, um das bereitgestellte Objekt und dessen Eigenschaften zu serialisieren.

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. In der Regel ist dies das Stammelement einer Seite oder Anwendung.

xmlWriter: XmlWriter

Writer zum Schreiben der serialisierten XAML-Informationen.

Ausnahmen

ArgumentNullException

obj oder xmlWriter ist null.

SecurityException

Die Anwendung wird nicht voll vertrauenswürdig ausgeführt.

Hinweise

Aufrufe Save sind nicht zulässig, wenn sie teilweise vertrauenswürdig ausgeführt werden.

Weitere Informationen

XamlReader

Gilt für:

Feedback

War diese Seite hilfreich?