XAML condicional

O XAML condicional fornece uma forma de usar o método ApiInformation.IsApiContractPresent diretamente na marcação XAML. Pode definir propriedades com base na presença de um contrato de API ao nível do sistema operativo sem escrever código por trás. As instruções condicionais são avaliadas em tempo de execução — os elementos qualificados com uma tag XAML condicional são processados caso sejam avaliados como true e ignorados caso contrário.

O XAML condicional requer a versão 1809 do Windows 10 (build 17763) ou posterior, que é a versão mínima do sistema operativo para aplicações do SDK de Aplicações Windows.

Pré-requisitos

• Um projeto do SDK de Aplicações Windows. Para os passos de configuração, consulte Criar a sua primeira aplicação WinUI 3.
• Familiaridade com aplicações adaptáveis à versão e com a ApiInformation classe.

Para informações gerais sobre ApiInformation e contratos de API, consulte aplicações adaptáveis à versão.

Espaços de nomes condicionais

Para usar um método condicional em XAML, declare um namespace XAML condicional no topo da sua página:

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

O conteúdo antes do ? delimitador é o namespace ou esquema. O conteúdo após ? é o método condicional que determina se o namespace avalia como true ou false.

Na maioria dos casos, o esquema é o namespace padrão XAML:

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

O XAML condicional suporta estes métodos condicionais:

Definir uma propriedade condicionalmente

Este exemplo mostra texto num TextBlock apenas quando a aplicação é executada no Windows 10, versão 1903 (Atualização de maio de 2019, build 18362) ou posterior — uma verificação de contrato que faz sentido porque é mais recente do que a versão mínima 1809 do SDK de Aplicações Windows.

Primeiro, defina um espaço de nomes condicional:

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

Depois, prefixe a propriedade com o namespace condicional:

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

Aqui está a margem completa:

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

O código de check-in equivalente abaixo:

TextBlock textBlock = new TextBlock();

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

Utilize condições if/else

Para definir valores diferentes dependendo do contrato API, defina tanto os namespaces condicionais positivo como negativo:

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)"

Depois define a propriedade duas vezes, cada uma com um prefixo condicional diferente. Apenas um é aplicado em tempo de execução:

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

Instanciar controlos condicionalmente

Conteúdo relacionado

• Aplicações adaptativas de versão
• Código adaptativo de versão