Bedingtes XAML

Bedingter XAML-Code bietet eine Möglichkeit, die ApiInformation.IsApiContractPresent-Methode direkt im XAML-Markup zu verwenden. Sie können Eigenschaften basierend auf dem Vorhandensein eines API-Vertrags auf Betriebssystemebene festlegen, ohne Code-Behind zu schreiben. Bedingte Anweisungen werden zur Laufzeit ausgewertet – Elemente, die mit einem bedingten XAML-Tag qualifiziert sind, werden geparst, wenn sie den Wert true ergeben, andernfalls werden sie ignoriert.

Bedingter XAML-Code erfordert Windows 10 Version 1809 (Build 17763) oder höher, was die Mindestversion des Betriebssystems für Windows App SDK-Apps ist.

Prerequisites

• Ein Windows App SDK Projekt. Schritte zum Einrichten finden Sie unter Erstellen Ihrer ersten WinUI 3-App.
• Vertrautheit mit versionsadaptiven Apps und der ApiInformation-Klasse.

Hintergrundinformationen zu ApiInformation Und API-Verträgen finden Sie unter Versionsadaptive Apps.

Bedingte Namespaces

Um eine bedingte Methode in XAML zu verwenden, deklarieren Sie oben auf der Seite einen bedingten XAML-Namespace :

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

Der Inhalt vor dem ? Trennzeichen ist der Namespace oder das Schema. Der Inhalt nach ? ist die bedingte Methode, die bestimmt, ob der Namespace als true oder false ausgewertet wird.

In den meisten Fällen ist das Schema der standardmäßige XAML-Namespace:

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

Bedingter XAML-Code unterstützt diese bedingten Methoden:

Eine Eigenschaft bedingt festlegen

In diesem Beispiel wird Text TextBlock nur angezeigt, wenn die App auf Windows 10 Version 1903 (Update vom Mai 2019, Build 18362) oder höher ausgeführt wird – eine Vertragsüberprüfung, die aussagekräftig ist, da sie neuer als die 1809 Etage des Windows App SDK ist.

Definieren Sie zunächst einen bedingten Namespace:

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

Stellen Sie dann der Eigenschaft den bedingten Namespace voran:

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

Hier ist das gesamte Markup:

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

Die entsprechende Überprüfung im CodeBehind:

TextBlock textBlock = new TextBlock();

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

Verwenden von If/Else-Bedingungen

Um je nach API-Vertrag unterschiedliche Werte festzulegen, definieren Sie sowohl die positiven als auch negativen bedingten Namespaces:

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

Legen Sie dann die Eigenschaft zweimal fest, jeweils mit einem anderen bedingten Präfix. Zur Laufzeit wird nur eins angewendet:

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

Steuerelemente bedingt instanziieren

Verwandte Inhalte

• Versionsadaptive Apps
• Versionsabhängiger Code