Feltételes XAML

A feltételes XAML lehetővé teszi az ApiInformation.IsApiContractPresent metódus közvetlen használatát az XAML-korrektúrában. A tulajdonságokat egy operációsrendszer-szintű API-szerződés jelenléte alapján állíthatja be anélkül, hogy kódokat ír le. A feltételes utasítások futásidőben értékelődnek ki – a feltételes XAML-címkével ellátott elemeket a rendszer feldolgozza, ha true értékre értékelődnek ki, ellenkező esetben pedig figyelmen kívül hagyja őket.

A feltételes XAML-hez Windows 10 1809-es (17763-as build) vagy újabb verzió szükséges, amely Windows App SDK alkalmazások minimális operációsrendszer-verziója.

Prerequisites

• Egy Windows App SDK projekt. A beállítás lépéseit az első WinUI 3-alkalmazás létrehozása című témakörben találja.
• Az adaptív verziójú alkalmazások és az ApiInformation osztály ismerete.

A háttérinformációkról és az API-szerződésekről ApiInformation lásd: Adaptív verziójú alkalmazások.

Feltételes névterek

Ha feltételes módszert szeretne használni az XAML-ben, deklaráljon egy feltételes XAML-névteret a lap tetején:

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

A határoló előtt lévő ? tartalom a névtér vagy séma. A ? utáni tartalom az a feltételes metódus, amely meghatározza, hogy a névtér true vagy false értékre értékelődik ki.

A legtöbb esetben a séma az alapértelmezett XAML-névtér:

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

A feltételes XAML a következő feltételes módszereket támogatja:

Tulajdonság feltételes beállítása

Ez a példa csak akkor jeleníti meg a szövegetTextBlock, ha az alkalmazás Windows 10 1903-ban (2019. májusi frissítés, 18362-es build) vagy újabb verzióban fut – ez a szerződés-ellenőrzés azért fontos, mert az újabb, mint a Windows App SDK 1809-es emelete.

Először definiáljon egy feltételes névteret:

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

Ezután lássa el a tulajdonságot a feltételes névtér előtagjával:

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

Íme a teljes jelölőkód:

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

Az ezzel egyenértékű bejelentkezési kód a háttérben:

TextBlock textBlock = new TextBlock();

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

If/else feltételek használata

Ha az API-szerződéstől függően különböző értékeket szeretne beállítani, adja meg a pozitív és a negatív feltételes névtereket is:

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

Ezután állítsa be kétszer a tulajdonságot, mindegyikhez egy másik feltételes előtag tartozik. Futtatókörnyezetben csak egy van alkalmazva:

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

Vezérlők feltételes példányosítása

Kapcsolódó tartalom

• Adaptív verziójú alkalmazások
• Adaptív verziókód