XamlServices.Load Metódus

Definíció

Névtér:

System.Xaml

Szerelvény:

System.Xaml.dll

Betölti az XAML-olvasó forrását, és a kimenetét objektumgráfként írja.

Túlterhelések

Name	Description
Load(Stream)	Betölt egy forrást Stream egy XAML-olvasóhoz, és a kimenetét objektumgráfként írja.
Load(TextReader)	Létrehoz egy XAML-olvasót egy TextReader, és visszaad egy objektumgráfot.
Load(String)	Betölt egy forrást Stream egy XAML-olvasóhoz, és visszaad egy objektumgráfot.
Load(XamlReader)	Betölt egy adott XAML-olvasó implementációt, és visszaad egy objektumgráfot.
Load(XmlReader)	Betölt egy adott XML-olvasó implementációt, és visszaad egy objektumgráfot.

Load(Stream)

Betölt egy forrást Stream egy XAML-olvasóhoz, és a kimenetét objektumgráfként írja.

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

Paraméterek

stream

Stream

A bemenetként betöltendő stream.

Válaszok

Object

A kimenetként írt objektumdiagram.

Kivételek

ArgumentNullException

stream az null.

Megjegyzések

A metódus különböző aláírásai Load(Stream) különböző típusú bemeneteket határoznak meg a forrás XAML-hez. A Load(Stream) belső implementáció először hívással Create(Stream) hoz létre egy XmlReader új példányt, majd létrehoz egy speciális XamlReader példányt, amely feldolgozza a bemenetet.

Ahhoz, hogy a Load(Stream) hívás sikeresen létrehozhasson egy objektumgráfot, a következőknek igaznak kell lenniük:

• A forrás jól formázott és érvényes XML.

• A forrás érvényes XAML a nyelvi szinten.

• A forrás XAML-ben megadott XAML-típusoknak fel kell oldaniuk a megfelelő XAML-névterek háttértípusait. A WPF névterek XAML-típusai például feloldhatók az XAML-ben megadott WPF XAML-névtérre; a WPF szerelvényeknek szerepelnie kell a projektben, vagy rendelkezésre kell állniuk a futási idő alatt; és így tovább.

Important

XamlServices nem ajánlott XAML olvasási vagy XAML írási API-készlet, ha Windows megjelenítési alaprendszer (WPF) típusokat vagy WPF alapuló típusokat dolgoz fel. A WPF használathoz használja a System.Windows.Markup.XamlReader XAML olvasásához vagy betöltéséhez; és System.Windows.Markup.XamlWriter az XAML visszaírásához. Ezek az osztályok System.Xaml API-kat használnak belsőleg a megvalósításuk során; azonban WPF-specifikus fogalmakat is támogatnak, amelyek befolyásolják az XAML olvasásának és írásának természetét, például a függőségi tulajdonságok optimalizálását.

Load(TextReader)

Létrehoz egy XAML-olvasót egy TextReader, és visszaad egy objektumgráfot.

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

Paraméterek

textReader

TextReader

A TextReader létrehozandó XmlReaderalapként használandó .

Válaszok

Object

A visszaadott objektumdiagram.

Kivételek

ArgumentNullException

textReader az null.

Megjegyzések

Az objektumdiagram visszaadásához a bemenetet a textReader megfelelő bemenet használatával kell létrehozni. Például át kell adnia egy StringReader olyan értéket, amelyet a konstruktor érvényes XAML-mint sztring bemenetével StringReader(String) kell létrehoznia.

Load(String)

Betölt egy forrást Stream egy XAML-olvasóhoz, és visszaad egy objektumgráfot.

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

Paraméterek

fileName

String

A betöltendő és forrásként használni kívánt fájlnév.

Válaszok

Object

A visszaadott objektumdiagram.

Kivételek

ArgumentNullException

fileName bemenet: null.

Megjegyzések

A metódus különböző aláírásai Load különböző típusú bemeneteket határoznak meg a forrás XAML-hez. A Load belső implementáció először hívással Create(String) hoz létre egy XmlReader új példányt, majd létrehoz egy speciális XamlReader példányt, amely feldolgozza a bemenetet.

Ahhoz, hogy a Load(String) hívás sikeresen létrehozhasson egy objektumgráfot, a következőknek igaznak kell lenniük:

• A forrás jól formázott és érvényes XML.

• A forrás érvényes XAML a nyelvi szinten.

• A forrás XAML-ben megadott XAML-típusoknak fel kell oldaniuk a megfelelő XAML-névterek háttértípusait. A WPF névterek XAML-típusai például feloldhatók az XAML-ben megadott WPF XAML-névtérre; a WPF szerelvényeknek szerepelnie kell a projektben, vagy rendelkezésre kell állniuk a futási időben; és így tovább.

Load(XamlReader)

Betölt egy adott XAML-olvasó implementációt, és visszaad egy objektumgráfot.

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

Paraméterek

xamlReader

XamlReader

A művelethez olvasóként Load használni kívánt XAML-olvasó implementáció.

Válaszok

Object

A visszaadott objektumdiagram.

Kivételek

ArgumentNullException

xamlReader bemenet: null.

Megjegyzések

Ezt az aláírást általában csak a következő esetekben érdemes használni:

• Ön definiálta a saját implementációját egy XamlReader.

• Olyan beállításokat XamlReader adott meg, amelyek eltérnek az alapértelmezett beállításoktól.

Load(XmlReader)

Betölt egy adott XML-olvasó implementációt, és visszaad egy objektumgráfot.

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

Paraméterek

xmlReader

XmlReader

A XmlReader művelethez olvasóként használandó Load implementáció.

Válaszok

Object

A kimeneti objektumdiagram.

Kivételek

ArgumentNullException

xmlReader bemenet: null.

Megjegyzések

Ezt az aláírást általában csak akkor érdemes használnia, ha saját implementációját definiálta.XmlReader