XamlServices.Load Metoda

Definice

Obor názvů:

System.Xaml

Sestavení:

System.Xaml.dll

Načte zdroj pro čtenáře XAML a zapíše jeho výstup jako objektový graf.

Přetížení

Name	Description
Load(Stream)	Načte zdroj pro čtečku Stream XAML a zapíše jeho výstup jako objektový graf.
Load(TextReader)	Vytvoří čtečku XAML z objektu TextReadera vrátí graf objektu.
Load(String)	Stream Načte zdroj pro čtečku XAML a vrátí graf objektů.
Load(XamlReader)	Načte konkrétní implementaci čtečky XAML a vrátí graf objektů.
Load(XmlReader)	Načte konkrétní implementaci čtečky XML a vrátí graf objektů.

Load(Stream)

Načte zdroj pro čtečku Stream XAML a zapíše jeho výstup jako objektový graf.

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

Parametry

stream

Stream

Datový proud, který se má načíst jako vstup.

Návraty

Object

Graf objektu, který je zapsán jako výstup.

Výjimky

ArgumentNullException

stream je null.

Poznámky

Různé podpisy pro metodu Load(Stream) určují různé typy vstupu pro zdrojový XAML. Interní Load(Stream) implementace nejprve vytvoří XmlReader voláním Create(Stream) a pak vytvoří novou instanci specializovaného XamlReader , který zpracovává vstup.

Aby Load(Stream) volání úspěšně vytvořilo graf objektů, musí být splněné následující podmínky:

• Zdroj je správně formátovaný a platný KÓD XML.

• Zdroj je platný XAML na úrovni jazyka.

• Typy XAML zadané ve zdrojovém kódu XAML se musí překládat na záložní typy v příslušných oborech názvů XAML. Například typy XAML pro WPF (Windows Presentation Foundation) obory názvů se můžou přeložit na WPF (Windows Presentation Foundation) obor názvů XAML, jak je uvedeno v kódu XAML; sestavení pro WPF (Windows Presentation Foundation) musí být zahrnuta do projektu nebo dostupná v době běhu atd.

Important

XamlServices není doporučená sada rozhraní API pro čtení XAML nebo zápis XAML, pokud zpracováváte typy WPF (Windows Presentation Foundation) (Windows Presentation Foundation) nebo typy založené na WPF (Windows Presentation Foundation). Pro použití WPF (Windows Presentation Foundation) použijte System.Windows.Markup.XamlReader ke čtení nebo načítání XAML a System.Windows.Markup.XamlWriter k zápisu zpět XAML. Tyto třídy používají System.Xaml rozhraní API interně ve své implementaci. Poskytují však také podporu konceptů specifických pro WPF (Windows Presentation Foundation), které ovlivňují povahu čtení a zápisu XAML, jako jsou optimalizace vlastností závislostí.

Load(TextReader)

Vytvoří čtečku XAML z objektu TextReadera vrátí graf objektu.

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

Parametry

textReader

TextReader

Použití TextReader jako základ pro vytvořenou XmlReader.

Návraty

Object

Vrácený graf objektu.

Výjimky

ArgumentNullException

textReader je null.

Poznámky

Aby bylo možné vrátit graf objektu, textReader měl by být vstup vytvořen pomocí příslušného vstupu. Měl by například předat StringReader vytvořený objekt pomocí platného vstupu XAML jako řetězce pro StringReader(String) konstruktor.

Load(String)

Stream Načte zdroj pro čtečku XAML a vrátí graf objektů.

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

Parametry

fileName

String

Název souboru, který se má načíst a použít jako zdroj.

Návraty

Object

Vrácený graf objektu.

Výjimky

ArgumentNullException

fileName vstup je null.

Poznámky

Různé podpisy pro metodu Load určují různé typy vstupu pro zdrojový XAML. Interní Load implementace nejprve vytvoří XmlReader voláním Create(String) a pak vytvoří novou instanci specializovaného XamlReader , který zpracovává vstup.

Aby Load(String) volání úspěšně vytvořilo graf objektů, musí být splněné následující podmínky:

• Zdroj je správně formátovaný a platný KÓD XML.

• Zdroj je platný XAML na úrovni jazyka.

• Typy XAML zadané ve zdrojovém kódu XAML se musí překládat na záložní typy v příslušných oborech názvů XAML. Například typy XAML pro WPF (Windows Presentation Foundation) obory názvů se můžou přeložit na WPF (Windows Presentation Foundation) obor názvů XAML, jak je uvedeno v kódu XAML; sestavení pro WPF (Windows Presentation Foundation) musí být zahrnuta do projektu nebo musí být k dispozici v době běhu atd.

Load(XamlReader)

Načte konkrétní implementaci čtečky XAML a vrátí graf objektů.

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

Parametry

xamlReader

XamlReader

Implementace čtečky XAML, která se použije jako čtenář pro tuto Load operaci.

Návraty

Object

Vrácený graf objektu.

Výjimky

ArgumentNullException

xamlReader vstup je null.

Poznámky

Tento podpis byste obvykle měli používat pouze v následujících případech:

• Definovali jste vlastní implementaci .XamlReader

• Zadali jste nastavení, XamlReader která se liší od výchozího nastavení.

Load(XmlReader)

Načte konkrétní implementaci čtečky XML a vrátí graf objektů.

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

Parametry

xmlReader

XmlReader

Implementace XmlReader , která se má použít jako čtenář pro tuto Load operaci.

Návraty

Object

Graf výstupního objektu.

Výjimky

ArgumentNullException

xmlReader vstup je null.

Poznámky

Tento podpis byste měli obvykle použít pouze v případě, že jste definovali vlastní implementaci XmlReader.