XamlServices.Load Methode

Definition

Namespace:: System.Xaml

Assembly:: System.Xaml.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.

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

Überlädt

Name	Beschreibung
Load(Stream)	Lädt eine Stream Quelle für einen XAML-Reader und schreibt die 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 die 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 Stream, der als Eingabe geladen werden soll.

Gibt zurück

Object

Das Objektdiagramm, das als Ausgabe geschrieben wird.

Ausnahmen

ArgumentNullException

stream ist null.

Hinweise

Unterschiedliche Signaturen für die Load(Stream) Methode geben unterschiedliche Eingabetypen für die XAML-Quelle an. Die Load(Stream) interne Implementierung erstellt zuerst eine XmlReader durch Aufrufen und Create(Stream) anschließende Erstellung einer neuen Instanz einer speziellen XamlReader Instanz, die die Eingabe verarbeitet.

Damit der Load(Stream) Aufruf erfolgreich ein Objektdiagramm erstellt, muss Folgendes wahr sein:

Die Quelle ist wohlgeformt und gültiger XML-Code.
Die Quelle ist gültiger XAML-Code auf Sprachebene.
Die im XAML-Quell-Code angegebenen XAML-Typen müssen in die zugrunde stehenden XAML-Namespaces aufgelöst werden. Beispielsweise können XAML-Typen für WPF Namespaces in einen WPF XAML-Namespace aufgelöst werden, wie im XAML-Code angegeben. Die Assemblys für WPF müssen im Projekt enthalten sein oder in der Laufzeit verfügbar sein; usw.

Important

XamlServices ist 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 zum 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

Die TextReader zu verwendende Basis für die erstellte XmlReader.

Gibt zurück

Object

Das zurückgegebene Objektdiagramm.

Ausnahmen

ArgumentNullException

textReader ist null.

Hinweise

Um das Objektdiagramm zurückzugeben, sollte die textReader Eingabe mithilfe ihrer 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 als Quelle geladen und verwendet werden soll.

Gibt zurück

Object

Das zurückgegebene Objektdiagramm.

Ausnahmen

ArgumentNullException

fileName Eingabe ist null.

Hinweise

Unterschiedliche Signaturen für die Load Methode geben unterschiedliche Eingabetypen für die XAML-Quelle an. Die Load interne Implementierung erstellt zuerst eine XmlReader durch Aufrufen und Create(String) anschließende Erstellung einer neuen Instanz einer speziellen XamlReader Instanz, die die Eingabe verarbeitet.

Damit der Load(String) Aufruf erfolgreich ein Objektdiagramm erstellt, muss Folgendes wahr sein:

Die Quelle ist wohlgeformt und gültiger XML-Code.
Die Quelle ist gültiger XAML-Code auf Sprachebene.
Die im XAML-Quell-Code angegebenen XAML-Typen müssen in die zugrunde stehenden XAML-Namespaces aufgelöst werden. Beispielsweise können XAML-Typen für WPF Namespaces in einen WPF XAML-Namespace aufgelöst werden, wie im XAML-Code angegeben. Die Assemblys für WPF müssen im Projekt enthalten sein oder in der Laufzeit verfügbar sein usw.

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 zurückgegebene Objektdiagramm.

Ausnahmen

ArgumentNullException

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 einstellung angegeben, 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 Leser für diesen Load Vorgang verwendet werden soll.

Gibt zurück

Object

Das Ausgabeobjektdiagramm.

Ausnahmen

ArgumentNullException

xmlReader Eingabe ist null.

Hinweise

In der Regel sollten Sie diese Signatur nur verwenden, wenn Sie ihre eigene Implementierung einer .XmlReader

Gilt für:

Feedback

War diese Seite hilfreich?