条件 XAML

条件 XAML 提供直接在 XAML 标记中使用 ApiInformation.IsApiContractPresent 方法的方法。 可以基于 OS 级 API 协定的存在设置属性，而无需在后面编写代码。 条件语句在运行时进行求值——带有条件 XAML 标记的元素如果其求值结果为 true，则会被解析；否则会被忽略。

条件 XAML 需要Windows 10版本 1809（内部版本 17763）或更高版本，这是Windows 应用 SDK应用的最低操作系统版本。

先决条件

• Windows 应用 SDK项目。 有关设置步骤，请参阅 创建第一个 WinUI 3 应用。
• 熟悉 版本自适应应用 和 ApiInformation 类。

有关 ApiInformation 和 API 合约的背景信息，请参阅 版本自适应应用。

条件命名空间

若要在 XAML 中使用条件方法，请在页面顶部声明条件 XAML 命名空间 ：

xmlns:myNamespace="schema?conditionalMethod(parameter)"

分隔符前 ? 的内容是命名空间或架构。 ? 后面的内容是用于确定命名空间的求值结果是 true 还是 false 的条件方法。

在大多数情况下，架构是默认的 XAML 命名空间：

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

条件 XAML 支持以下条件方法：

有条件地设置属性

此示例仅在应用运行于 Windows 10 版本 1903（2019 年 5 月更新，内部版本 18362）或更高版本时，才会在 TextBlock 中显示文本——这种合约检查是有意义的，因为它比 Windows 应用 SDK 的 1809 最低版本要求更新。

首先，定义条件命名空间：

xmlns:contract8Present="http://schemas.microsoft.com/winfx/2006/xaml/presentation?IsApiContractPresent(Windows.Foundation.UniversalApiContract,8)"

然后，使用条件命名空间为属性添加前缀：

<TextBlock contract8Present:Text="Hello, Conditional XAML"/>

下面是完整的标记代码：

<Page
    x:Class="ConditionalTest.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:contract8Present="http://schemas.microsoft.com/winfx/2006/xaml/presentation?IsApiContractPresent(Windows.Foundation.UniversalApiContract,8)">

    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
        <TextBlock contract8Present:Text="Hello, Conditional XAML"/>
    </Grid>
</Page>

后台代码中的等效检查：

TextBlock textBlock = new TextBlock();

if (ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 8))
{
    textBlock.Text = "Hello, Conditional XAML";
}

使用 if/else 条件

若要根据 API 协定设置不同的值，请同时定义正条件命名空间和负条件命名空间：

xmlns:contract8NotPresent="http://schemas.microsoft.com/winfx/2006/xaml/presentation?IsApiContractNotPresent(Windows.Foundation.UniversalApiContract,8)"
xmlns:contract8Present="http://schemas.microsoft.com/winfx/2006/xaml/presentation?IsApiContractPresent(Windows.Foundation.UniversalApiContract,8)"

然后设置属性两次，每个属性具有不同的条件前缀。 运行时仅应用一个：

<TextBlock contract8NotPresent:Text="Hello, World"
           contract8Present:Text="Hello, May 2019 Update or later"/>

按条件实例化控件

相关内容

• 版本自适应应用
• 版本自适应代码