XAML 概述
我们将向 Windows 运行时应用开发人员介绍 XAML 语言和 XAML 概念,并介绍在使用 XAML 创建 Windows 运行时应用时,在 XAML 中声明对象和设置属性的不同方式。
什么是 XAML?
Extensible Application Markup Language (Extensible Application Markup Language, XAML) 是一种声明性语言。具体来讲,XAML 可初始化对象和设置对象的属性,使用一种可显示多个对象间分层关系的语言结构,还使用了一种支持类型扩展的支持类型约定。你可以在声明性的 XAML 标记中创建可视的 UI 元素。然后你可以为每个 XAML 文件关联一个独立的代码隐藏文件,以响应事件和处理最初在 XAML 中声明的对象。
在开发过程中,XAML 语言支持不同工具和角色之间的源代码交换,例如在设计工具与 IDE 或是主开发人员与本地化开发人员之间交换 XAML 源代码。通过将 XAML 用作交换格式,可以分开或整合设计人员角色和开发人员角色,并且设计人员和开发人员可以在开发应用期间迭代。
如果将它们视为 Windows 运行时应用项目的一部分,则 XAML 文件即是带 .xaml 扩展名的 XML 文件。
基本 XAML 语法
XAML 的基本语法基于 XML。依照定义,有效的 XAML 必须也是有效的 XML。但 XAML 也拥有可赋予不同且更加完整含义的语法概念,根据 XML 1.0 规范,它在 XML 中也有效。例如,XAML 支持属性元素语法,其中属性值可在元素中设置,而不是在属性中作为字符串值或内容进行设置。对于常规 XML 而言,XAML 属性元素是名称中带点号的元素,因此它对于纯 XML 有效,但具有不同的含义。
XAML 与 Microsoft Visual Studio
无论是在 XAML 文本编辑器中,还是在更为图形化的 XAML 设计界面中,Microsoft Visual Studio 都可以帮助你生成有效的 XAML 语法。因此在你使用 Visual Studio 为应用编写 XAML 时,不必时时担心语法问题。IDE 鼓励通过提供自动完成提示、在 Microsoft IntelliSense 列表和下拉列表中显示建议、在工具箱中显示 UI 元素库或其他技术等方式,来编写有效的 XAML 语法。如果这是你第一次使用 XAML,则当我们在参考或其他主题中介绍 XAML 语法时,了解语法规则可能仍然有用,特别是有时用于描述限制或选择的术语。我们将在基本 XAML 语法指南这个单独主题中介绍 XAML 语法的这五个要点。
XAML 命名空间
在常规编程中,命名空间是一种组织概念,用于确定如何解释编程实体的标识符。通过使用命名空间,编程框架可将用户声明的标识符与框架声明的标识符区分开、通过命名空间限定消除标识符的歧义、强制执行范围名称规则等。XAML 具有为 XAML 语言实现此用途的其自己的 XAML 命名空间概念。下面是 XAML 应用并扩展 XML 语言命名空间概念的方式:
- XAML 可将保留的 XML 属性 xmlns 用于命名空间声明。该属性的值通常是一个统一资源标识符 (URI),它是从 XML 继承的约定。
- XAML 使用声明性前缀来声明非默认命名空间,并声明元素和属性中使用的前缀引用该命名空间。
- XAML 有一个叫做默认命名空间的概念,当不使用或声明任何现有前缀时,便会使用该命名空间。针对每一个 XAML 编程框架,可以对默认命名空间进行不同的定义。
- 在 XAML 文件或构造中,命名空间定义从父元素继承到子元素。例如,如果你在 XAML 文件的根元素中定义命名空间,该文件中的所有元素都将继承该命名空间定义。如果以后添加到该页面中的某个元素重新定义了命名空间,则该元素的后代将继承新定义。
- 一个元素的属性继承该元素的命名空间。XAML 属性很少有前缀。
XAML 文件几乎总是在其根元素中声明一个默认 XAML 命名空间。默认 XAML 命名空间定义了无需使用前缀来限定即可声明哪些元素。对于典型的 Windows 运行时应用项目,此默认命名空间包含用于 UI 定义的所有 Windows 运行时的内置 XAML 词汇:默认控件、文本元素、XAML 图形和动画、数据绑定和样式支持类型等。因此,为 Windows 运行时应用编写的大部分 XAML 在引用常见 UI 元素时都将避免使用 XAML 命名空间和前缀。
如下代码段显示了用模板创建的一个应用初始页面的 Page 根(仅显示了开始标记并且进行了简化)。它声明了默认命名空间,还有 x 命名空间(将在下面加以介绍)。
<Page x:Class="Application1.BlankPage" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
XAML 语言 XAML 命名空间
一种在几乎每个 Windows 运行时 XAML 文件中都会声明的特定的 XAML 命名空间是 XAML 命名空间。此命名空间包括由 XAML 语言按其语言规范定义的元素和概念。根据约定,XAML 语言 XAML 命名空间会映射到前缀 "x"。Windows 运行时应用项目的默认项目和文件模板始终会将默认 XAML 命名空间(没有前缀,只有 xmlns=
)和 XAML 语言 XAML 命名空间(前缀为 "x")定义为根元素的一部分。
"x" 前缀/XAML 语言 XAML 命名空间包含你在 XAML 中经常使用的多种编程结构。下面是一些最常见的结构:
术语 | 描述 |
---|---|
为 XAML ResourceDictionary 中的每个资源设置一个唯一的用户定义密钥。该密钥的令牌字符串是StaticResource 标记扩展的参数,你可以在以后使用此密钥在应用 XAML 的其他位置检索其他 XAML 用法中的 XAML 资源。 |
|
为 XAML 页面提供代码隐藏的类指定代码命名空间和代码类名称。这可为构建你的应用时通过构建操作创建或加入的类命名。这些构建操作支持 XAML 标记编译器,并在编译应用时,将你的标记和代码隐藏文件组合到一起。你必须具有此类,才能支持对 XAML 页面实现代码隐藏。还需要 x:Class,才能使你的 XAML 内容在默认 Windows 运行时激活模型中初始化为 Window.Content。 |
|
在处理 XAML 中定义的对象元素后,为运行时代码中存在的实例指定一个运行时对象名。你可以将在 XAML 中设置 x:Name 看作是在代码中声明命名变量。稍后你会了解,这是将 XAML 加载为 Windows 运行时应用的一个组件时发生的实际情况。 注意 FrameworkElement.Name 是框架中的一个类似属性,并非所有元素都支持它。因此,当FrameworkElement.Name 在该元素类型上不受支持时,你可以将 x:Name 用于元素标识。 |
|
标识某些元素,应将本地化后的资源用于该元素的一些属性值。有关如何使用 x:Uid 的详细信息,请参阅快速入门:翻译 UI 资源。 |
|
当属性或资源需要时,这些类型可以为简单的值类型指定值。这些固有类型与通常定义为每个编程语言固有定义的一部分的简单值类型相对应。例如,你可能需要一个表示 true 布尔值的对象,以便在ObjectAnimationUsingKeyFrames 情节提要视觉状态中使用。对于 XAML 中的该值,可将 x:Boolean固有类型用作对象元素,例如 |
在 XAML 语言 XAML 命名空间中还存在其他编程结构,但没有这么常用。有关详细信息,请参阅 XAML 命名空间 (x:) 语言功能。
将自定义类型映射到 XAML 命名空间
作为一种语言,XAML 功能最强大的方面之一在于,可以轻松地扩展 Windows 运行时应用的 XAML 词汇。你可以使用应用的编程语言定义自己的自定义类型,然后在 XAML 标记中引用你的自定义类型。从根本上讲,通过自定义类型提供的扩展支持已经内置于 XAML 语言的工作原理。框架或应用开发人员负责创建 XAML 引用的支持对象。框架和应用开发人员都不会因为这些对象所代表的规范或不符合基本 XAML 语法规则而受到限制(对于 XAML 语言 XAML 命名空间类型的行为有一些预期要求,但 Windows 运行时会提供所有必要支持)。
如果你为来自非 Windows 运行时核心库和元数据的类型使用 XAML,则必须声明和映射带前缀的 XAML 命名空间。在元素用法中使用该前缀以引用已在你的库中定义的类型。通常,你可以在根元素以及其他 XAML 命名空间定义中将前缀映射声明为 xmlns 属性。
要使你自己的命名空间定义引用自定义类型,你首先需要指定关键字 xmlns:,然后指定所需的前缀。 该属性的值必须包含关键字 using:,将其作为该值的第一部分。该值的其余部分为字符串令牌,它按名称引用特定的代码支持的命名空间,并且其中还包含你的自定义类型。
该前缀定义的标记令牌用于在该 XAML 文件中标记的剩余部分中引用该 XAML 命名空间。前缀与要在 XAML 命名空间中引用的实体之间有一个冒号字符 (:)。
例如,将前缀 myTypes
映射到命名空间 myCompany.myTypes
的属性语法为:xmlns:myTypes="using:myCompany.myTypes"
,而代表的元素用法为:<myTypes:CustomButton/>
有关为自定义类型映射 XAML 命名空间的详细信息,包括 Visual C++ 组件扩展 (C++/CX) 的特殊注意事项,请参阅XAML 命名空间和命名空间映射。
其他 XAML 命名空间
你常常会看到定义前缀 "d"(设计器命名空间)和 "mc"(用于实现标记兼容性)的 XAML 文件。它们通常用于基础结构支持,或者用于启用设计时工具中的方案。有关详细信息,请参阅 XAML 命名空间主题中的“其他 XAML 命名空间”部分。
标记扩展
标记扩展是一个 XAML 语言概念,常常用在 Windows 运行时 XAML 实现中。标记扩展通常表示某种“快捷方式”,它允许 XAML 文件访问无法只根据支持类型声明元素的值或行为。某些标记可通过纯字符串或其他嵌套的元素设置属性,目的是简化不同 XAML 文件之间的语法或因素处理。
在 XAML 属性语法中,花括号 "{" 和 "}" 表示 XAML 标记扩展用法。此用法指示 XAML 处理从对属性值的一般处理转义为处理文字字符串,或者处理一个可直接进行字符串转换的值。相反,XAML 分析器将调用提供该特定标记扩展行为的代码,以及提供 XAML 分析器所需的备用对象或行为结果的代码。标记扩展可以具有参数,这些参数遵循标记扩展名称,也包含在花括号中。通常,评估的标记扩展可提供对象返回值。分析期间,该返回值将插入到对象树的某个位置中,在该位置中标记扩展用法已位于源 XAML 中。
Windows 运行时 XAML 支持在默认 XAML 命名空间下定义并可被 Windows 运行时 XAML 分析程序理解的标记扩展:
- Binding:支持数据绑定,它会延迟一个属性值,直到该值在仅在运行时存在的数据上下文下被解释。 此标记扩展支持很多参数。有关详细信息,请参阅绑定标记扩展。
- StaticResource:支持引用在一个 ResourceDictionary 中定义的资源值。这些资源可以位于不同的 XAML 文件中,但最终必须在加载时可供 XAML 分析器查找。
{StaticResource}
用法的参数标识 ResourceDictionary 中的键控资源的键(名称)。 - ThemeResource:类似于 StaticResource 但可响应运行时主题变更。ThemeResource 经常位于 Windows 运行时的默认 XAML 模板中,因为其中的大部分模板专门用于用户在应用运行时切换主题的兼容性。
- TemplateBinding:Binding 的一种特殊情况,它支持 XAML 中的控制模板及其在运行时的最终用法。
- RelativeSource:支持一种特定形式的模板绑定,其中的值来自于父模板。
- CustomResource:适用于资源查找的高级场景。
Windows 运行时还支持 x:Null 标记扩展。 你可以使用它在 XAML 中将 Nullable 值设置为 null。例如,你可以将其用于 CheckBox 的控制模板,这会将 null 解释为不确定的选中状态(从而引发 "Indeterminate" 视觉状态)。
标记扩展一般会从应用的对象图的其他某个部分返回一个现有实例,或者将一个值延迟到运行时。因为可以将标记扩展用作属性值,并且这是典型用法,所以你经常可以看到标记扩展被用来为引用类型的属性提供值,而采用其他方式时,这些属性可能需要使用属性元素语法。
例如,下面是用于从 ResourceDictionary 中引用可重用的 Style 的语法:<Button Style="{StaticResource SearchButtonStyle}"/>
。Style 是一种引用类型而非一个简单值,因此如果没有 {StaticResource}
用法,你需要使用<Button.Style>
属性元素和其中的 <Style>
定义来设置 FrameworkElement.Style 属性。
通过使用标记扩展,在 XAML 中可设置的所有属性都可能采用属性语法进行设置。你可以使用属性语法提供一个属性的引用值,即使它不支持通过其他方法用于直接对象实例化的属性语法也是如此。或者可以实现一种特定的行为,通过值类型或新创建的引用类型来延迟需填充 XAML 属性的一般需求。
为举例说明,接下来的 XAML 示例使用属性语法来设置一个 Border 的 Style 属性的值。Style 属性接受 Style 类的一个实例,一个在默认情况下无法使用属性语法字符串创建的引用类型。但在本例中,该属性引用一个特定的标记扩展StaticResource。当处理该标记扩展时,它返回对之前已被定义为资源字典中的键控资源的一个 Style 元素的引用。
<Canvas.Resources> <Style TargetType="Border" x:Key="PageBackground"> <Setter Property="BorderBrush" Value="Blue"/> <Setter Property="BorderThickness" Value="5"/> </Style> </Canvas.Resources> ... <Border Style="{StaticResource PageBackground}"> ... </Border>
有关介绍 Windows 运行时 XAML 中可用标记扩展的参考主题,请参阅 Windows 运行时命名空间扩展或 XAML 命名空间 (x:) 语言功能。
你可以嵌套使用标记扩展。会首先计算最里层的标记扩展。
由于标记扩展的缘故,你需要使用特殊语法来表示属性中的 "{" 文本值。有关详细信息,请参阅基本 XAML 语法指南。
事件
XAML 是一种用于对象及其属性的声明性语言,但它也包含向标记中的对象附加事件处理程序的语法。XAML 事件语法可通过 Windows 运行时编程模型集成 XAML 声明的事件。在处理事件的对象上,将事件的名称指定为一个属性名称。对于属性值,指定你在代码中定义的一个事件处理函数的名称。XAML 处理器使用此名称在加载的对象树中创建一个委托表示,将指定的处理程序添加到内部处理程序列表中。 几乎所有 Windows 运行时应用都是同时通过标记和代码隐藏源文件定义的。
下面是一个简单示例。Button 类支持一个名为 Click 的事件。你可以为 Click 编写处理程序,用以运行在用户单击Button 之后应当调用的代码。在 XAML 中,你可以将 Click 指定为 Button 上的一个属性。对于属性值,请提供一个表示你的处理程序的方法名称的字符串。
<Button Click="showUpdatesButton_Click">Show updates</Button>
当你进行编译时,编译器现在预期在代码隐藏文件中将有一个已定义的名为 showUpdatesButton_Click
的方法,位于 XAML 页的 x:Class 值中声明的命名空间中。另外,该方法必须满足 Click 事件的委派合约。例如:
namespace App1 { public sealed partial class MainPage: Page { ... private void showUpdatesButton_Click (object sender, RoutedEventArgs e) { //your code } } }
在一个项目中,将 XAML 编写为 .xaml 文件,使用你最喜欢的语言(C#、Visual Basic、C++/CX)编写一个代码隐藏文件。当在项目的生成操作中对 XAML 文件进行标记编译时,可以通过将一个命名空间和类指定为 XAML 页面根元素的x:Class 属性来标识每个 XAML 页面的 XAML 代码隐藏文件的位置。 有关这些机制在 XAML 中如何工作以及它们与编程和应用程序模型之间的关系的详细信息,请参阅事件和路由事件概述。
注意 对于 C++/CX,存在两个代码隐藏文件,一个是标头 (.xaml.h),另一个是实现 (.xaml.cpp)。该实现引用标头,从技术上讲,标头表示代码隐藏连接的入口点。
资源字典
创建 ResourceDictionary 是一种常见任务,这通常是通过将资源字典创建为 XAML 页面的一个区域或创建为一个单独的 XAML 文件来完成的。资源字典以及如何使用资源字典是一个非常大的概念区域,不在本主题的讨论范围内。有关详细信息,请参阅 ResourceDictionary 和 XAML 资源引用。
XAML 和 XML
XAML 语言基本上基于 XML 语言。 但 XAML 显著扩展了 XML。具体来讲,由于它与支持类型概念之间的关系,它处理架构概念的方式显著不同,并且它添加了很多语言元素,例如附加成员和标记扩展。xml:lang 在 XAML 中是有效的,但会影响运行时而不是分析行为,通常又称为一种框架级属性。有关详细信息,请参阅FrameworkElement.Language。xml:base 在标记中是有效的,但分析器会忽略它。xml:space 是有效的,但仅与XAML 和空格主题中介绍的场景相关。encoding 属性在 XAML 中是有效的。仅支持 UTF-8 和 UTF-16 编码。不支持 UTF-32 编码。
XAML 中区分大小写
XAML 中是区分大小写的。这是 XAML 基于 XML 的另一个后果,XML 是区分大小写的。XAML 元素和属性的名称是区分大小写的。属性的值可能区分大小写,这取决于为特定属性处理属性值的方式。例如,如果属性值声明一个枚举的成员名称,将成员名称字符串进行类型转换,以返回枚举成员值的内部行为是不区分大小写的。相反,Name 属性的值和基于 Name 属性声明的名称来处理对象的实用程序方法会对名称字符串区分大小写。
XAML 名称范围
XAML 语言定义了一个 XAML 名称范围的概念。XAML 名称范围概念会影响 XAML 处理器在处理可用于 XAML 的x:Name 或 Name 值时的方式,特别是依赖名称成为唯一标识符的领域。XAML 名称范围将在一个单独的主题中详细介绍;请参阅 XAML 名称范围。
XAML 在开发过程中的作用
XAML 在应用开发过程中发挥着多项重要作用。
- 如果使用 C#、Visual Basic 或 C++/CX 编程,XAML 是声明应用的 UI 和该 UI 中各个元素的主要格式。通常,项目中至少有一个 XAML 文件表示应用中最初显示的 UI 的页面隐喻。更多的 XAML 文件可以为导航 UI 声明更多页面。其他 XAML 文件可声明资源,例如模板或样式。
- 使用 XAML 格式为应用的控件和 UI 声明样式和模板。
- 你可以使用样式和模板将现有控件模板化,或者定义一个控件,在一个控件包中提供默认模板。当使用 XAML 格式定义样式和模板时,相关的 XAML 常常使用 ResourceDictionary 根声明为独立的 XAML 文件。
- XAML 是设计器用于支持创建应用 UI 和在不同设计器应用之间交换 UI 设计的通用格式。最重要的是,应用的 XAML 可在不同的 XAML 设计工具(或工具中的设计窗口)之间交换。
- 其他一些技术也使用 XAML 定义基本 UI。相对于 Windows Presentation Foundation (WPF) XAML 和 Microsoft Silverlight XAML,Windows 运行时的 XAML 使用同一个适用于其共享的默认 XAML 命名空间的 URI。Windows 运行时的 XAML 词汇表与 Silverlight 使用的 XAML-for-UI 词汇表具有大量重复内容,与 WPF 所使用的词汇表的重复内容稍微少一些。因此,XAML 为最初为也使用 XAML 的早期技术定义的 UI 提供了一种有效的迁移路径。
- XAML 定义 UI 的可视外观,一个关联的代码隐藏文件定义逻辑。无需更改代码隐藏文件中的逻辑,即可调整 UI 设计。XAML 简化了设计人员与开发人员之间的工作流。
- 得益于丰富的可视设计器和对 XAML 语言的设计图面的支持,XAML 支持在早期开发阶段快速设计 UI 原型。
取决于你自己在开发流程中的角色,你可能不会与 XAML 进行太多交互。你与 XAML 文件的交互程度还取决于你使用哪个开发环境、是否使用交互式设计环境功能(例如工具箱和属性编辑器),以及 Windows 运行时应用的范围和用途。但是可能在应用开发期间,你将在元素级别使用文本或 XML 编辑器来编辑 XAML 文件。使用此信息,你可以以文本或 XML 表示形式自信地编辑 XAML,并在工具、标记编译操作或 Windows 运行时应用的运行时阶段使用 XAML 文件时保持该文件的声明和用途的有效性。
优化你的 XAML 以提高加载性能
在使用 XAML 定义 UI 元素时,对于使用有利于性能的最佳做法,有一些技巧。这些技巧中有许多与使用 XAML 资源有关,但为了方便起见,在此一般 XAML 概述中还是将它们列了出来。有关 XAML 资源的详细信息,请参阅ResourceDictionary 和 XAML 资源引用。要了解更多有关性能的提示,包括特意展示在 XAML 中应避免的某些欠佳性能做法的 XAML,请参阅优化加载 XAML。
- 如果你经常在 XAML 中使用相同的颜色画笔,请将 SolidColorBrush 定义为一个资源,而不是每次都使用某种已命名的颜色作为属性值。
- 如果你在一个 UI 页面上多次使用同一资源,请考虑在 Application.Resources 中而不是在每个页面上定义该资源。反之,如果只有一个页面使用某个资源,则不要在 Application.Resources 中定义该资源,而只为需要该资源的页面定义它。这对设计应用时的 XAML 构造和 XAML 分析过程中的性能都有好处。
- 对于你的应用打包的资源,请检查是否有未使用的资源(这类资源具有键,但在你的应用中没有 StaticResource 引用使用该资源)。在发布你的应用之前,请从 XAML 中删除这些资源。
- 如果你使用了提供设计资源的单独 XAML 文件 (MergedDictionaries),请考虑从这些文件中注释掉或者删除未使用的资源。即使你有在多个应用中使用的共享 XAML 起始点或者有为你的所有应用提供共用资源的共享 XAML 起始点,你的应用仍然每次都会打包 XAML 资源,并可能需要加载它们。
- 请不要定义组合所不需要的 UI 元素,并尽可能地使用默认的控件模板(这些模板已经过加载性能方面的测试和验证)。
- 请使用 Border 之类的容器而不要故意过度绘制 UI 元素。一般情况下,请不要多次绘制同一像素。有关过度绘制和如何进行相应测试的详细信息,请参阅 DebugSettings.IsOverdrawHeatMapEnabled。
- 针对 ListView 或 GridView 使用默认的项目模板;这些模板具有特殊的 Presenter 逻辑,用于在为大量列表项构建可视化树时解决性能问题。
调试 XAML
因为 XAML 是一种标记语言,所以用于在 Visual Studio 中调试的一些典型策略不可用。例如,无法在 XAML 文件中设置断点。不过,有其他的技术可帮助你调试与 UI 定义或其他 XAML 标记相关的问题,与此同时,你仍然可开发你的应用。
当 XAML 文件存在问题时,最典型的结果是某些系统或你的应用不会引发 XAML 分析异常。只要存在 XAML 分析异常,由 XAML 分析程序加载的 XAML 就无法创建有效的对象树。在某些情况下,比如当 XAML 声明作为根视觉对象加载的应用程序的第一“页”时,XAML 分析异常不可恢复。
通常在 IDE(例如 Visual Studio 及其某一个 XAML 设计图面)中编辑 XAML。Visual Studio 通常可提供设计时的验证,以及在编辑 XAML 源时的错误检查。例如,只要你键入无效的属性值,它可能在 XAML 文本编辑器中显示“曲线”,而且你甚至不必等待 XAML 编译通过,就可看到 UI 定义中的错误。
一旦应用真正运行,如果任何 XAML 分析错误在设计时未经检测,公共语言运行时 (CLR) 就会报告这些错误作为XamlParseException。有关可以对运行时 XamlParseException 执行的操作的详细信息,请参阅采用 C# 或 Visual Basic 的 Windows 运行时应用的异常处理。
注意 针对代码使用 C++/CX 的应用不能获取特定 XamlParseException。但是该异常与 XamlParseException 一样,包含的消息可阐明错误源与 XAML 相关,并且在 XAML 文件中包括上下文信息(例如行数)。
有关调试 Windows 运行时应用的详细信息,请参阅启动调试会话。