语言

XamlServices.Load 方法

定义

加载 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

要作为输入加载的流。

返回

作为输出写入的对象图。

例外

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的基础。

返回

返回的对象图。

例外

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

要加载和使用作为源的文件名。

返回

返回的对象图。

例外

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 读取器实现。

返回

返回的对象图。

例外

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读取器的实现。

返回

输出对象图。

例外

xmlReader 输入为 null.

注解

通常,只有在定义了自己的实现时 XmlReader,才应使用此签名。

适用于