APIxref:System.Windows.Markup.XamlWriter.Save*可用于序列化的内容Windows Presentation Foundation (WPF)应用程序作为可扩展应用程序标记语言 (XAML)文件。 但是,对于所序列化的内容有一些显著限制。 本主题对这些限制和某些一般注意事项进行了介绍。
运行时、非设计时表示形式
什么通过调用序列化的基本原理xref:System.Windows.Markup.XamlWriter.Save*是结果将是正在序列化,在运行时对象的表示形式。 许多设计时属性的原始XAML文件可能已进行了优化或丢失时,XAML加载为内存中对象,并在调用时不会保留xref:System.Windows.Markup.XamlWriter.Save*要序列化。 序列化的结果是应用程序的结构化逻辑树的有效表示形式,但并不一定是生成该树的原始 XAML 的有效表示形式。 这些问题变得极为困难,若要使用xref:System.Windows.Markup.XamlWriter.Save*一部分的一个全面的序列化XAML设计图面。
序列化是自包含的
序列化的输出xref:System.Windows.Markup.XamlWriter.Save*是自包含; 进行序列化的所有内容,包含在XAML单个页上,使用一个根元素,并且不包含外部引用以外的其他URI。 例如,如果页面从应用程序资源引用了资源,则这些资源看上去如同正在进行序列化的页面的一个组件。
取消引用扩展引用
由各种标记扩展格式(如 StaticResource 或 Binding)对对象进行的公共引用将会由序列化进程取消引用。 已时内存中对象所创建的应用程序运行时,将这些取消引用和xref:System.Windows.Markup.XamlWriter.Save*逻辑不会重新访问原始XAML还原序列化输出到此类引用。 这样可能会将任何数据绑定的或资源获得的值冻结为运行时表示形式最后使用的值,并且只能有限地或间接地区别这样的值与任何其他在本地设置的值。 由于图像存在于项目中,因此图像也会序列化为图像的对象引用(而不是原始的源引用),从而会丢失最初引用的文件名或 URI。 即使是在同一页面内声明的资源,也会序列化到引用点内,而不是保留为资源集合的键。
不保留事件处理
当对通过 XAML 添加的事件处理程序进行序列化后,不会保留这些事件处理程序。 不具有代码隐藏功能(并且也不具有相关的 x:Code 机制)的 XAML 无法对运行时过程逻辑进行序列化。 因为序列化是自包含的且限于逻辑树,所以不存在用于存储事件处理程序的设施。 因此,会从输出 XAML 中删除事件处理程序特性(特性本身和用于命名处理程序的字符串值)。
XAMLWriter.Save 实用方案
虽然限制列出以下是非常重大,仍有几个相应的使用方案xref:System.Windows.Markup.XamlWriter.Save*进行序列化。
-
向量或图形输出:呈现区域的输出可用于重现相同的向量或图形时重新加载。
-
丰富的文本和流文档:文本和在其中的所有元素格式和元素包含保留在输出中。 这对类似于剪贴板功能的机制可能非常有用。
-
保留业务对象数据:如果数据中存储自定义元素,如XML数据,因此只要您的业务对象遵循基本XAML规则,如提供自定义构造函数和转换,则为按引用属性值,这些业务对象可以是通过序列化永久保留。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
