XAML condicional

XAML condicional permite usar el método ApiInformation.IsApiContractPresent directamente en el marcado XAML. Puede establecer propiedades en función de la presencia de un contrato de API de nivel de sistema operativo sin escribir código subyacente. Las instrucciones condicionales se evalúan en tiempo de ejecución: los elementos marcados con una etiqueta XAML condicional se analizan si se evalúan como true y, de lo contrario, se ignoran.

XAML condicional requiere Windows 10 versión 1809 (compilación 17763) o posterior, que es la versión mínima del sistema operativo para las aplicaciones de SDK de Aplicaciones para Windows.

Prerequisites

• Un proyecto de SDK de Aplicaciones para Windows. Para conocer los pasos de configuración, consulte Creación de la primera aplicación winUI 3.
• Familiaridad con las aplicaciones adaptables a la versión y la clase ApiInformation.

Para obtener información general sobre ApiInformation y los contratos de API, consulte Aplicaciones adaptables a versiones.

Espacios de nombres condicionales

Para usar un método condicional en XAML, declare un espacio de nombres XAML condicional en la parte superior de la página:

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

El contenido anterior al ? delimitador es el espacio de nombres o el esquema. El contenido después de ? es el método condicional que determina si el espacio de nombres se evalúa en true o false.

En la mayoría de los casos, el esquema es el espacio de nombres XAML predeterminado:

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

Xaml condicional admite estos métodos condicionales:

Establecimiento de una propiedad de forma condicional

En este ejemplo, se muestra texto en un TextBlock solo cuando la aplicación se ejecuta en Windows 10, versión 1903 (Actualización de mayo de 2019, compilación 18362) o una versión posterior; una comprobación de contrato que tiene sentido porque es más reciente que la versión mínima 1809 de SDK de Aplicaciones para Windows.

En primer lugar, defina un espacio de nombres condicional:

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

A continuación, prefijo la propiedad con el espacio de nombres condicional:

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

Aquí está el código de marcado completo:

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

La comprobación equivalente en el código subyacente:

TextBlock textBlock = new TextBlock();

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

Utilizar condiciones if/else

Para establecer valores diferentes en función del contrato de API, defina los espacios de nombres condicionales positivos y negativos:

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

A continuación, establezca la propiedad dos veces, cada una con un prefijo condicional diferente. Solo se aplica una en tiempo de ejecución:

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

Creación de instancias de controles de forma condicional

Contenido relacionado

• Aplicaciones adaptables a la versión
• Código adaptable de versión