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) реализация сначала создает XmlReaderCreate(Stream) вызов, а затем создает новый экземпляр специализированного XamlReader , обрабатывающего входные данные.

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

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

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

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

Important

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 реализация сначала создает XmlReaderCreate(String) вызов, а затем создает новый экземпляр специализированного XamlReader , обрабатывающего входные данные.

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

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

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

• Типы XAML, указанные в исходном XAML, должны разрешаться для резервных типов в соответствующих пространствах имен XAML. Например, типы XAML для пространств имен WPF могут разрешаться в пространство имен XAML WPF, как указано в 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

xmlReaderвходные данные .null

Комментарии

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