Freigeben über


XamlServices.Load Methode

Definition

Lädt die Quelle für einen XAML-Reader und schreibt dessen Ausgabe als Objektdiagramm.

Überlädt

Load(Stream)

Lädt eine Stream-Quelle für einen XAML-Reader und schreibt dessen Ausgabe als Objektdiagramm.

Load(TextReader)

Erstellt einen XAML-Reader aus einem TextReader und gibt ein Objektdiagramm zurück.

Load(String)

Lädt eine Stream-Quelle für einen XAML-Reader und gibt ein Objektdiagramm zurück.

Load(XamlReader)

Lädt eine bestimmte XAML-Readerimplementierung und gibt ein Objektdiagramm zurück.

Load(XmlReader)

Lädt eine bestimmte XML-Readerimplementierung und gibt ein Objektdiagramm zurück.

Load(Stream)

Lädt eine Stream-Quelle für einen XAML-Reader und schreibt dessen Ausgabe als Objektdiagramm.

public:
 static System::Object ^ Load(System::IO::Stream ^ stream);
public static object Load (System.IO.Stream stream);
static member Load : System.IO.Stream -> obj
Public Shared Function Load (stream As Stream) As Object

Parameter

stream
Stream

Der Datenstrom, der als Eingabe geladen werden soll.

Gibt zurück

Object

Das Objektdiagramm, das als Ausgabe geschrieben wird.

Ausnahmen

stream ist null.

Hinweise

Unterschiedliche Signaturen für die Load(Stream) Methode geben unterschiedliche Eingabetypen für den Quell-XAML-Code an. Die Load(Stream) interne Implementierung erstellt zunächst einen XmlReader Aufruf Create(Stream) und erstellt dann eine neue Instanz einer speziellen XamlReader Instanz, die die Eingabe verarbeitet.

Damit der Load(Stream) Aufruf erfolgreich ein Objektdiagramm erstellen kann, muss folgendes true sein:

  • Die Quelle ist gut gebildet und gültiger XML-Code.

  • Die Quelle ist gültiger XAML-Code auf Sprachebene.

  • Die XAML-Typen, die in der Quell-XAML angegeben sind, müssen aufgelöst werden, um Typen in den relevanten XAML-Namespaces zu sichern. Beispielsweise können XAML-Typen für WPF-Namespaces wie im XAML-Code angegeben in einen WPF-XAML-Namespace aufgelöst werden; die Assemblys für WPF müssen im Projekt enthalten sein oder in der Laufzeit verfügbar sein; Und so weiter.

Wichtig

XamlServicesist nicht der empfohlene XAML-Lese- oder XAML-Schreib-API-Satz, wenn Sie Windows Presentation Foundation (WPF)-Typen oder Typen basierend auf WPF verarbeiten. Verwenden Sie System.Windows.Markup.XamlReader für die WPF-Verwendung das Lesen oder Laden von XAML und System.Windows.Markup.XamlWriter zum Schreiben von XAML. Diese Klassen verwenden System.Xaml APIs intern in ihrer Implementierung. Sie bieten jedoch auch Unterstützung für WPF-spezifische Konzepte, die die Art des XAML-Lesens und Schreibens beeinflussen, z. B. Optimierungen für Abhängigkeitseigenschaften.

Gilt für

Load(TextReader)

Erstellt einen XAML-Reader aus einem TextReader und gibt ein Objektdiagramm zurück.

public:
 static System::Object ^ Load(System::IO::TextReader ^ textReader);
public static object Load (System.IO.TextReader textReader);
static member Load : System.IO.TextReader -> obj
Public Shared Function Load (textReader As TextReader) As Object

Parameter

textReader
TextReader

Der TextReader, der als Basis für den erstellten XmlReader verwendet werden soll.

Gibt zurück

Object

Das Objektdiagramm, das zurückgegeben wird.

Ausnahmen

textReader ist null.

Hinweise

Um das Objektdiagramm zurückzugeben, sollte die textReader Eingabe mithilfe seiner relevanten Eingabe erstellt werden. Beispielsweise sollte ein StringReader Objekt übergeben werden, das mithilfe einer gültigen XAML-as-String-Eingabe für den StringReader(String) Konstruktor erstellt wird.

Gilt für

Load(String)

Lädt eine Stream-Quelle für einen XAML-Reader und gibt ein Objektdiagramm zurück.

public:
 static System::Object ^ Load(System::String ^ fileName);
public static object Load (string fileName);
static member Load : string -> obj
Public Shared Function Load (fileName As String) As Object

Parameter

fileName
String

Der Dateiname, der geladen und als Quelle verwendet werden soll.

Gibt zurück

Object

Das Objektdiagramm, das zurückgegeben wird.

Ausnahmen

fileName-Eingabe ist null.

Hinweise

Unterschiedliche Signaturen für die Load Methode geben unterschiedliche Eingabetypen für den Quell-XAML-Code an. Die Load interne Implementierung erstellt zunächst einen XmlReader Aufruf Create(String) und erstellt dann eine neue Instanz einer speziellen XamlReader Instanz, die die Eingabe verarbeitet.

Damit der Load(String) Aufruf erfolgreich ein Objektdiagramm erstellen kann, muss folgendes true sein:

  • Die Quelle ist gut gebildet und gültiger XML-Code.

  • Die Quelle ist gültiger XAML-Code auf Sprachebene.

  • Die XAML-Typen, die in der Quell-XAML angegeben sind, müssen aufgelöst werden, um Typen in den relevanten XAML-Namespaces zu sichern. Beispielsweise können XAML-Typen für WPF-Namespaces wie im XAML-Code angegeben in einen WPF-XAML-Namespace aufgelöst werden; die Assemblys für WPF müssen im Projekt enthalten sein oder in der Laufzeit verfügbar sein; Und so weiter.

Gilt für

Load(XamlReader)

Lädt eine bestimmte XAML-Readerimplementierung und gibt ein Objektdiagramm zurück.

public:
 static System::Object ^ Load(System::Xaml::XamlReader ^ xamlReader);
public static object Load (System.Xaml.XamlReader xamlReader);
static member Load : System.Xaml.XamlReader -> obj
Public Shared Function Load (xamlReader As XamlReader) As Object

Parameter

xamlReader
XamlReader

Die XAML-Readerimplementierung, die als Reader für diesen Load-Vorgang verwendet werden soll.

Gibt zurück

Object

Das Objektdiagramm, das zurückgegeben wird.

Ausnahmen

xamlReader-Eingabe ist null.

Hinweise

In der Regel sollten Sie diese Signatur nur in den folgenden Fällen verwenden:

  • Sie haben ihre eigene Implementierung einer XamlReader.

  • Sie haben Einstellungen für eine XamlReader festgelegt, die sich von den Standardeinstellungen unterscheidet.

Gilt für

Load(XmlReader)

Lädt eine bestimmte XML-Readerimplementierung und gibt ein Objektdiagramm zurück.

public:
 static System::Object ^ Load(System::Xml::XmlReader ^ xmlReader);
public static object Load (System.Xml.XmlReader xmlReader);
static member Load : System.Xml.XmlReader -> obj
Public Shared Function Load (xmlReader As XmlReader) As Object

Parameter

xmlReader
XmlReader

Die XmlReader-Implementierung, die als Reader für den Load-Vorgang verwendet werden soll.

Gibt zurück

Object

Das Ausgabeobjektdiagramm.

Ausnahmen

xamlReader-Eingabe ist null.

Hinweise

Diese Signatur sollte normalerweise nur verwendet werden, wenn Sie ihre eigene Implementierung einer XmlReader.

Gilt für