Udostępnij za pośrednictwem

XamlServices.Load Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xaml
Zestaw:
System.Xaml.dll

Ładuje źródło dla czytnika XAML i zapisuje jego dane wyjściowe jako wykres obiektu.

Przeciążenia

Load(Stream)

Stream Ładuje źródło dla czytnika XAML i zapisuje jego dane wyjściowe jako wykres obiektu.
Load(TextReader)

Tworzy czytnik XAML z elementu TextReaderi zwraca graf obiektu.
Load(String)

Stream Ładuje źródło dla czytnika XAML i zwraca graf obiektu.
Load(XamlReader)

Ładuje określoną implementację czytnika XAML i zwraca graf obiektu.
Load(XmlReader)

Ładuje konkretną implementację czytnika XML i zwraca graf obiektu.

Load(Stream)

Stream Ładuje źródło dla czytnika XAML i zapisuje jego dane wyjściowe jako wykres obiektu.

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

Strumień do załadowania jako dane wejściowe.

Zwraca

Object

Wykres obiektu, który jest zapisywany jako dane wyjściowe.

Wyjątki

ArgumentNullException

stream to null.

Uwagi

Różne sygnatury Load(Stream) dla metody określają różne typy danych wejściowych dla źródłowego kodu XAML. Implementacja wewnętrzna Load(Stream) najpierw tworzy obiekt XmlReader przez wywołanie Create(Stream) , a następnie tworzy nowe wystąpienie wyspecjalizowanego XamlReader , które przetwarza dane wejściowe.

Aby Load(Stream) wywołanie pomyślnie utworzyło graf obiektu, musi mieć wartość true:

  • Źródło jest dobrze sformułowane i prawidłowe xml.

  • Źródło jest prawidłowym językiem XAML na poziomie języka.

  • Typy XAML określone w źródłowym języku XAML muszą zostać rozpoznane w celu utworzenia kopii zapasowych typów w odpowiednich przestrzeniach nazw XAML. Na przykład typy XAML dla przestrzeni nazw WPF mogą rozpoznawać przestrzeń nazw WPF XAML, jak określono w języku XAML; zestawy dla WPF muszą być uwzględnione w projekcie lub dostępne w czasie wykonywania; itd.

Ważne

XamlServicesnie jest zalecanym odczytem XAML lub zestawem interfejsu API zapisywania XAML, jeśli przetwarzasz typy Windows Presentation Foundation (WPF) lub typy oparte na WPF. W przypadku użycia WPF należy użyć do System.Windows.Markup.XamlReader odczytywania lub ładowania kodu XAML oraz System.Windows.Markup.XamlWriter zapisywania kodu XAML. Klasy te używają System.Xaml interfejsów API wewnętrznie w ich implementacji. Jednak zapewniają one również obsługę pojęć specyficznych dla platformy WPF, które wpływają na charakter odczytywania i zapisywania kodu XAML, takich jak optymalizacje właściwości zależności.

Dotyczy

Load(TextReader)

Tworzy czytnik XAML z elementu TextReaderi zwraca graf obiektu.

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

Element TextReader do użycia jako podstawa dla utworzonego XmlReaderpliku .

Zwraca

Object

Zwrócony graf obiektu.

Wyjątki

ArgumentNullException

textReader to null.

Uwagi

Aby zwrócić wykres obiektu, textReader dane wejściowe powinny być konstruowane przy użyciu odpowiednich danych wejściowych. Na przykład należy przekazać StringReader obiekt skonstruowany przy użyciu prawidłowego wejściowego kodu XAML jako ciągu dla konstruktora StringReader(String) .

Dotyczy

Load(String)

Stream Ładuje źródło dla czytnika XAML i zwraca graf obiektu.

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

Nazwa pliku do załadowania i użycia jako źródła.

Zwraca

Object

Zwrócony graf obiektu.

Wyjątki

ArgumentNullException

fileName dane wejściowe to null.

Uwagi

Różne sygnatury Load dla metody określają różne typy danych wejściowych dla źródłowego kodu XAML. Implementacja wewnętrzna Load najpierw tworzy obiekt XmlReader przez wywołanie Create(String) , a następnie tworzy nowe wystąpienie wyspecjalizowanego XamlReader , które przetwarza dane wejściowe.

Aby Load(String) wywołanie pomyślnie utworzyło graf obiektu, musi mieć wartość true:

  • Źródło jest dobrze sformułowane i prawidłowe xml.

  • Źródło jest prawidłowym językiem XAML na poziomie języka.

  • Typy XAML określone w źródłowym języku XAML muszą zostać rozpoznane w celu utworzenia kopii zapasowych typów w odpowiednich przestrzeniach nazw XAML. Na przykład typy XAML dla przestrzeni nazw WPF mogą rozpoznawać przestrzeń nazw WPF XAML, jak określono w języku XAML; zestawy dla WPF muszą być uwzględnione w projekcie lub być dostępne w czasie wykonywania; itd.

Dotyczy

Load(XamlReader)

Ładuje określoną implementację czytnika XAML i zwraca graf obiektu.

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

Implementacja czytnika XAML do użycia jako czytelnik dla tej Load operacji.

Zwraca

Object

Zwrócony graf obiektu.

Wyjątki

ArgumentNullException

xamlReader dane wejściowe to null.

Uwagi

Zazwyczaj należy używać tego podpisu tylko w następujących przypadkach:

  • Zdefiniowano własną implementację elementu XamlReader.

  • Określono ustawienia XamlReader , które różnią się od ustawień domyślnych.

Dotyczy

Load(XmlReader)

Ładuje konkretną implementację czytnika XML i zwraca graf obiektu.

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

Implementacja XmlReader do użycia jako czytelnik dla tej Load operacji.

Zwraca

Object

Wykres obiektu wyjściowego.

Wyjątki

ArgumentNullException

xamlReader dane wejściowe to null.

Uwagi

Zazwyczaj należy używać tego podpisu tylko wtedy, gdy zdefiniowano własną implementację elementu XmlReader.

Dotyczy