Język

XamlServices.Load Metoda

Definicja

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

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

Przeciążenia

Nazwa Opis
Load(Stream)

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

Tworzy czytnik XAML na podstawie TextReaderelementu i 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 określoną implementację czytnika XML i zwraca graf obiektu.

Load(Stream)

Stream Ładuje źródło dla czytnika XAML i zapisuje swoje dane wyjściowe jako graf 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

Parametr stream ma wartość null.

Uwagi

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

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

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

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

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

Ważna

XamlServices nie jest zalecanym odczytem XAML lub zestawem interfejsu API pisania XAML w przypadku przetwarzania typów programu Windows Presentation Foundation (WPF) lub typów opartych na WPF. W przypadku użycia platformy WPF użyj System.Windows.Markup.XamlReader funkcji odczytu lub ładowania kodu XAML oraz System.Windows.Markup.XamlWriter zapisywania z powrotem kodu XAML. Klasy te używają System.Xaml interfejsów API wewnętrznie w ich implementacji, ale zapewniają również obsługę koncepcji specyficznych dla platformy WPF, które mają wpływ na charakter odczytywania i zapisywania kodu XAML, takich jak optymalizacje właściwości zależności.

Dotyczy

Load(TextReader)

Tworzy czytnik XAML na podstawie TextReaderelementu i 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 XmlReaderelementu .

Zwraca

Object

Zwrócony graf obiektu.

Wyjątki

ArgumentNullException

Parametr textReader ma wartość 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ć obiekt StringReader 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 input to null.

Uwagi

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

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

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

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

  • Typy XAML określone w źródłowym kodzie XAML muszą rozpoznawać typy kopii zapasowych w odpowiednich przestrzeniach nazw XAML. Na przykład typy XAML dla przestrzeni nazw WPF mogą być rozpoznawane jako WPF przestrzeń nazw XAML określona 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 input to null.

Uwagi

Ten podpis należy zwykle używać tylko w następujących przypadkach:

  • Zdefiniowano własną implementację obiektu XamlReader.

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

Dotyczy

Load(XmlReader)

Ładuje określoną 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

xmlReader input to null.

Uwagi

Ten podpis należy zwykle używać tylko wtedy, gdy zdefiniowano własną implementację elementu XmlReader.

Dotyczy