大网数据广告活动
.NET 与 C# 开发

XAML 中的空白处理

· 52CE 我爱测

XAML 的语言规则状态必须由!INCLUDE[TLA2#tla_xaml]处理器实现处理有效空白。 本主题介绍这些 XAML 语言规则。 它还记录了由 xaml 处理器的!INCLUDE[TLA#tla_winclient]实现和用于序列化的 xaml 编写器定义的其他空白空间处理。

XAML 的语言规则状态必须由XAML处理器实现处理有效空白。 本主题介绍这些 XAML 语言规则。 它还记录了由 xaml 处理器的Windows Presentation Foundation (WPF)实现和用于序列化的 xaml 编写器定义的其他空白空间处理。

空格定义

与XML一致, 中XAML的空格字符是空格、换行符和制表符。这些字符分别对应于 Unicode 值 0020、000A 和 0009。

空白标准化

默认情况下, 当XAML处理器XAML处理文件时, 将发生以下空白标准化:

  1. 删除中文字符间的换行符。 有关此术语的定义,请稍后参阅本主题中的“中文字符”一节。

  2. 所有空白字符 (空格、换行符、制表符) 都转换为空格。

  3. 删除所有连续的空格,并替换为一个空格。

  4. 删除开始标记后紧跟的一个空格。

  5. 删除结束标记前紧跟的一个空格。

“默认”对应于由 xml: space 属性的默认值表示的状态。

内部文本和字符串基元中的空格

先前的标准化规则适用于 XAML 元素中找到的内部文本。 标准化后,XAML 处理器将所有内部文本转换为适当的类型,如下所示:

  • 如果属性的类型不是一个集合,但不直接是 xref:System.Object 类型,则 XAML 处理器会尝试使用其类型转换器来转换为该类型。 此处的转换失败将导致编译时错误。

  • 如果该属性的类型是一个集合,并且内部文本是连续的(无干扰元素标记),则内部文本解析为单个 xref:System.String。 如果集合类型不能接受 xref:System.String,这也会导致编译时错误。

  • 如果该属性的类型为 xref:System.Object,则内部文本解析为单个 xref:System.String。 如果存在干扰元素标记,这将导致编译时错误,因为 xref:System.Object 类型表示单个对象(xref:System.String 或其他)。

  • 如果属性的类型是一个集合,并且内部文本是不连续的,则第一个子字符串将转换为 xref:System.String 并添加为集合项,干扰元素将添加为集合项,并且最后尾随的子字符串(如果有)将作为第三个 xref:System.String 项添加到集合。

保留空白

有几种方法可用于保留源XAML中的空白, 以最终表示不XAML受处理器空白标准化的影响。

xml:space="preserve" :在需要空白保留空间的元素级别指定此属性。 这样保留了所有的空格,其中包括可能由代码编辑应用程序添加到“优质打印”对齐元素以作为可视化直观嵌套的空格。 但是,是否呈现这些空白是由包含元素的内容模型决定的。 避免在xml:space="preserve"根级别指定, 因为无论你如何设置该属性, 大多数对象模型都不会将空格视为重要。 全局设置 xml:space 可能对 XAML 在某些实现中的处理(特别是序列化)产生性能后果。 更好的做法是仅在元素级别上设置属性, 这些元素会在字符串中呈现空白, 或者是空白的重要集合。

实体和非换行空格: XAML 支持在文本对象模型中放置任何 Unicode 实体。 可以在 utf-8 编码中使用专用实体, 如不#间断空格 (& 160;)。 还可以使用支持不间断空格字符的富文本控件。 如果使用实体来模拟布局特征(例如缩进),则应当小心,因为实体的运行时输出将根据更大数量的因素变化,而不是根据在典型布局系统中产生缩进结果的能力,如面板和边距的正确使用。 例如,实体映射到字体,并且可以响应用户的字体选择更改大小。

东亚字符

“中文字符”定义为一组 Unicode 字符,范围是 U+20000 到 U+2FFFD 与 U+30000 到 U+3FFFD。 此子集有时也称为“CJK 表意文字”。 有关详细信息,请参阅 https://www.unicode.org。

空格和文本内容模型

在实践中, 保留空白只是为了实现所有可能的内容模型的子集。 该子集由内容模型组成,这些模型可以采用某种形式的单独 xref:System.String 类型、专用 xref:System.String 集合,或 xref:System.String 和 xref:System.Collections.IList 或 xref:System.Collections.Generic.ICollection`1 集合中其他类型的混合。

WPF 中的空格和文本内容模型

为了便于说明,此部分的其余部分引用由 WPF 定义的特定类型。 本主题中描述的空格处理功能通常与 .NET Framework XAML 服务和 WPF 相关。 若要查看运行中的此行为,可以使用一些 WPF XAML 标记进行试验,在对象图中查看结果,然后重新序列化为标记。

即使对于可以采用字符串的内容模型, 这些内容模型内的默认行为也不会被视为重要。 例如, xref:System.Windows.Controls.ListBox xref:System.Collections.IList采用, 但不会保留且不会呈现空格 (如每个xref:System.Windows.Controls.ListBoxItem空白之间的换行符)。 如果尝试使用换行符作为 xref:System.Windows.Controls.ListBoxItem 项的字符串之间的分隔符,则完全不适用;由换行符分隔的字符串将被视为一个字符串和一个项。

那些将空格视为重要的集合通常是流文档模型的一部分。 支持空白保存行为的主集合为xref:System.Windows.Documents.InlineCollection。 此集合类与一起xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute声明; 找到此属性时XAML , 处理器会将集合内的空格视为重要。 xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute表示的集合xml:space="preserve"中的和空格的组合是指保留并呈现所有空格。 xml:space="default" 和xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute中的空格组合会导致前面所述的初始空白标准化, 这会在某些位置留下一个空格, 并保留并呈现这些空格。 需要哪种行为由你决定,并且应有选择地使用 xml:space 以启用需要的行为。

此外, 流文档模型中换行符 linebreak 的某些内联元素应特意不引入额外的空间, 即使是在空白有意义的集合中。 例如, xref:System.Windows.Documents.LineBreak元素与 HTML 中的\ 标记具有相同的用途, 为标记中的可读性, 通常是由创作xref:System.Windows.Documents.LineBreak的换行符与任何后续文本分隔开。 不应标准化该换行符以使它成为后续行中的前导空格。 若要启用此行为, xref:System.Windows.Documents.LineBreak则元素的类定义xref:System.Windows.Markup.TrimSurroundingWhitespaceAttribute将应用, 然后由XAML处理器进行解释, 以表示始终修整周围xref:System.Windows.Documents.LineBreak的空格。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。