XamlServices.Load Метод

Определение

Пространство имен:

System.Xaml

Сборка:

System.Xaml.dll

Загружает источник для средства чтения XAML и записывает его вывод в виде графа объекта.

Перегрузки

Load(Stream)	Загружает источник Stream для средства чтения XAML и записывает его вывод в виде графа объекта.
Load(TextReader)	Создает средство чтения XAML на основе TextReader и возвращает граф объекта.
Load(String)	Загружает источник Stream для средства чтения XAML и возвращает граф объекта.
Load(XamlReader)	Загружает конкретную реализацию средства чтения XAML и возвращает граф объектов.
Load(XmlReader)	Загружает конкретную реализацию средства чтения XML и возвращает граф объектов.

Load(Stream)

Загружает источник Stream для средства чтения XAML и записывает его вывод в виде графа объекта.

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

Параметры

stream

Stream

Поток, загружаемый как входные данные.

Возвращаемое значение

Object

Граф объекта, который записывается как вывод.

Исключения

ArgumentNullException

stream имеет значение null.

Комментарии

Разные сигнатуры Load(Stream) для метода указывают разные типы входных данных для исходного XAML. Внутренняя Load(Stream) реализация сначала создает путем XmlReader вызова Create(Stream) , а затем создает новый экземпляр специализированного XamlReader объекта , который обрабатывает входные данные.

Для успешного создания графа объекта при вызове Load(Stream) должно быть выполнено следующее:

• Источником является правильно сформированный и допустимый XML-код.

• Источником является допустимый КОД XAML на уровне языка.

• Типы XAML, указанные в исходном коде XAML, должны разрешаться в резервные типы в соответствующих пространствах имен XAML. Например, типы XAML для пространств имен WPF могут разрешаться в пространство имен WPF XAML, как указано в XAML; сборки для WPF должны быть включены в проект или доступны во время выполнения; и так далее.

Важно!

XamlServicesне является рекомендуемыми наборами API для чтения или записи XAML, если вы обрабатываете типы Windows Presentation Foundation (WPF) или типы на основе WPF. Для использования WPF используйте System.Windows.Markup.XamlReader для чтения или загрузки XAML, а System.Windows.Markup.XamlWriter также для обратной записи XAML. Эти классы используют System.Xaml API для внутренней реализации, но они также обеспечивают поддержку концепций WPF, которые влияют на характер чтения и записи XAML, например оптимизацию свойств зависимостей.

Load(TextReader)

Создает средство чтения XAML на основе TextReader и возвращает граф объекта.

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

Параметры

textReader

TextReader

Объект TextReader для использования в качестве основы для созданного XmlReader.

Возвращаемое значение

Object

Возвращаемый граф объекта.

Исключения

ArgumentNullException

textReader имеет значение null.

Комментарии

Чтобы вернуть граф объекта, textReader входные данные должны быть созданы с использованием соответствующих входных данных. Например, он должен передавать объект , StringReader созданный с использованием допустимых входных данных XAML как строки для конструктора StringReader(String) .

Load(String)

Загружает источник Stream для средства чтения XAML и возвращает граф объекта.

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

Параметры

fileName

String

Имя файла для загрузки и использования в качестве источника.

Возвращаемое значение

Object

Возвращаемый граф объекта.

Исключения

ArgumentNullException

Входное значение fileName равно null.

Комментарии

Разные сигнатуры Load для метода указывают разные типы входных данных для исходного XAML. Внутренняя Load реализация сначала создает путем XmlReader вызова Create(String) , а затем создает новый экземпляр специализированного XamlReader объекта , который обрабатывает входные данные.

Для успешного создания графа объекта при вызове Load(String) должно быть выполнено следующее:

• Источником является правильно сформированный и допустимый XML-код.

• Источником является допустимый КОД XAML на уровне языка.

• Типы XAML, указанные в исходном коде XAML, должны разрешаться в резервные типы в соответствующих пространствах имен XAML. Например, типы XAML для пространств имен WPF могут разрешаться в пространство имен WPF XAML, как указано в XAML; сборки для WPF должны быть включены в проект или доступны во время выполнения; и так далее.

Load(XamlReader)

Загружает конкретную реализацию средства чтения XAML и возвращает граф объектов.

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

Параметры

xamlReader

XamlReader

Реализация средства чтения XAML, которую следует использовать в качестве средства чтения для этой операции Load.

Возвращаемое значение

Object

Возвращаемый граф объекта.

Исключения

ArgumentNullException

Входное значение xamlReader равно null.

Комментарии

Обычно эту сигнатуру следует использовать только в следующих случаях:

• Вы определили собственную реализацию XamlReader.

• Вы указали параметры для , XamlReader которые отличаются от параметров по умолчанию.

Load(XmlReader)

Загружает конкретную реализацию средства чтения XML и возвращает граф объектов.

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

Параметры

xmlReader

XmlReader

Реализация объекта XmlReader, которую следует использовать в качестве средства чтения для этой операции Load.

Возвращаемое значение

Object

Выходной граф объектов.

Исключения

ArgumentNullException

Входное значение xamlReader равно null.

Комментарии

Обычно эту сигнатуру следует использовать только в том случае, если вы определили собственную реализацию XmlReader.