Sdílet prostřednictvím


XamlServices.Load Metoda

Definice

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

Přetížení

Load(Stream)

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

Load(TextReader)

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

Load(String)

Stream Načte zdroj pro čtenáře 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)

Stream Načte zdroj pro čtenáře 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 objektů, který je napsaný jako výstup.

Výjimky

stream je null.

Poznámky

Různé podpisy metody Load(Stream) určují různé typy vstupu pro zdrojový KÓD 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 objektový graf, musí být splněné následující:

  • Zdroj je dobře vytvořený a platný XML.

  • Zdroj je platný xaml na úrovni jazyka.

  • Typy XAML zadané ve zdrojovém kódu XAML se musí přeložit na typy zálohování v příslušných oborech názvů XAML. Například typy XAML pro obory názvů WPF můžou přeložit na obor názvů WPF XAML, jak je uvedeno v souboru XAML; sestavení pro WPF musí být zahrnuta v projektu nebo musí být k dispozici v době běhu; a tak dále.

Důležité

XamlServicespokud zpracováváte typy Windows Presentation Foundation (WPF) nebo typy založené na WPF, nedoporučuje se čtení XAML ani sada rozhraní API pro zápis XAML. Pro použití WPF 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, které ovlivňují povahu čtení a zápisu XAML, například optimalizace vlastností závislostí.

Platí pro

Load(TextReader)

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

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ý objektový graf.

Výjimky

textReader je null.

Poznámky

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

Platí pro

Load(String)

Stream Načte zdroj pro čtenáře 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ý objektový graf.

Výjimky

fileName vstup je null.

Poznámky

Různé podpisy metody Load určují různé typy vstupu pro zdrojový KÓD 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 objektový graf, musí být splněné následující:

  • Zdroj je dobře vytvořený a platný XML.

  • Zdroj je platný xaml na úrovni jazyka.

  • Typy XAML zadané ve zdrojovém kódu XAML se musí přeložit na typy zálohování v příslušných oborech názvů XAML. Například typy XAML pro obory názvů WPF můžou přeložit na obor názvů WPF XAML, jak je uvedeno v souboru XAML; sestavení pro WPF musí být zahrnuta v projektu nebo musí být k dispozici v době běhu; a tak dále.

Platí pro

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ý objektový graf.

Výjimky

xamlReader vstup je null.

Poznámky

Tento podpis byste měli obvykle 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í.

Platí pro

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 použije jako čtenář pro tuto Load operaci.

Návraty

Object

Graf výstupního objektu.

Výjimky

xamlReader vstup je null.

Poznámky

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

Platí pro