XamlServices.Load 方法

定义

命名空间:
System.Xaml
程序集:
System.Xaml.dll

加载 XAML 读取器的源，并将其输出作为对象图写入。

重载

名称 说明
Load(Stream)

Stream加载 XAML 读取器的源，并将其输出作为对象图写入。
Load(TextReader)

从 /> 创建 XAML 读取器并返回对象图。
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) 调用成功创建对象图，必须为 true：

  • 源格式正确且有效的 XML。

  • 源是语言级别的有效 XAML。

  • 源 XAML 中指定的 XAML 类型必须解析为相关 XAML 命名空间中的支持类型。 例如，WPF命名空间的 XAML 类型可以解析为 XAML 中指定的WPF XAML 命名空间;WPF的程序集必须包含在项目中或运行时可用;等等。

Important

XamlServices 如果你正在处理基于 WPF 的 Windows Presentation Foundation （WPF） 类型或类型，则不建议使用 XAML 读取或 XAML 写入 API 集。 对于 WPF 用法，用于 System.Windows.Markup.XamlReader 读取或加载 XAML;以及 System.Windows.Markup.XamlWriter 写回 XAML。 这些类在其实现中内部使用 System.Xaml API;但是，它们还支持影响 XAML 读取和写入性质的 WPF 特定概念，例如依赖项属性的优化。

适用于

Load(TextReader)

从 /> 创建 XAML 读取器并返回对象图。

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) 调用成功创建对象图，必须为 true：

  • 源格式正确且有效的 XML。

  • 源是语言级别的有效 XAML。

  • 源 XAML 中指定的 XAML 类型必须解析为相关 XAML 命名空间中的支持类型。 例如，WPF命名空间的 XAML 类型可以解析为 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

用作此操作 Load 的读取器的 XAML 读取器实现。

返回

Object

返回的对象图。

例外

ArgumentNullException

xamlReader 输入为 null.

注解

通常仅在以下情况下使用此签名：

适用于

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，才应使用此签名。

适用于