XamlServices.Load 方法

定义

命名空间:

System.Xaml

程序集:

System.Xaml.dll

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

重载

Load(Stream)	加载 XAML 读取器的 Stream 源，并将其输出写为对象关系图。
Load(TextReader)	从 TextReader 创建 XAML 读取器，并返回对象关系图。
Load(String)	加载 XAML 读取器的 Stream 源，并返回对象关系图。
Load(XamlReader)	加载特定 XAML 读取器实现，并返回对象图。
Load(XmlReader)	加载特定 XML 读取器实现，并返回对象图。

Load(Stream)

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

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)实现首先通过调用 Create(Stream) 创建 ，XmlReader然后创建处理输入的专用 XamlReader 的新实例。

为了使 Load(Stream) 调用成功创建对象图，必须满足以下条件：

• 源的格式正确且有效。

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

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

重要

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

Load(TextReader)

从 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)

加载 XAML 读取器的 Stream 源，并返回对象关系图。

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实现首先通过调用 Create(String) 创建 ，XmlReader然后创建处理输入的专用 XamlReader 的新实例。

为了使 Load(String) 调用成功创建对象图，必须满足以下条件：

• 源的格式正确且有效。

• 源是语言级别的有效 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.

注解

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

• 你定义了自己的 实现 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

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

返回

Object

输出对象关系图。

例外

ArgumentNullException

xamlReader 输入为 null.

注解

通常，仅当定义了自己的 实现时 XmlReader，才应使用此签名。