Langage

OnPlatformExtension Classe

Définition

Fournit une extension de balisage XAML qui retourne des valeurs différentes en fonction de la plateforme sur laquelle l’application s’exécute.

public ref class OnPlatformExtension : Microsoft::Maui::Controls::Xaml::IMarkupExtension
[Microsoft.Maui.Controls.ContentProperty("Default")]
[Microsoft.Maui.Controls.Xaml.RequireService(new System.Type[] { typeof(Microsoft.Maui.Controls.Xaml.IProvideValueTarget), typeof(Microsoft.Maui.Controls.Xaml.IValueConverterProvider), typeof(Microsoft.Maui.Controls.Xaml.IXmlLineInfoProvider), typeof(Microsoft.Maui.Controls.Xaml.IConverterOptions) })]
public class OnPlatformExtension : Microsoft.Maui.Controls.Xaml.IMarkupExtension
[Microsoft.Maui.Controls.ContentProperty("Default")]
public class OnPlatformExtension : Microsoft.Maui.Controls.Xaml.IMarkupExtension
[<Microsoft.Maui.Controls.ContentProperty("Default")>]
[<Microsoft.Maui.Controls.Xaml.RequireService(new System.Type[] { typeof(Microsoft.Maui.Controls.Xaml.IProvideValueTarget), typeof(Microsoft.Maui.Controls.Xaml.IValueConverterProvider), typeof(Microsoft.Maui.Controls.Xaml.IXmlLineInfoProvider), typeof(Microsoft.Maui.Controls.Xaml.IConverterOptions) })>]
type OnPlatformExtension = class
    interface IMarkupExtension
[<Microsoft.Maui.Controls.ContentProperty("Default")>]
type OnPlatformExtension = class
    interface IMarkupExtension
Public Class OnPlatformExtension
Implements IMarkupExtension
Héritage
OnPlatformExtension
Attributs
Implémente

Remarques

La valeur est résolue en correspondant à l’identificateur Platform (valeur DevicePlatform du ToString() struct) par rapport aux valeurs par plateforme. Par conséquent, un back-end personnalisé dont la chaîne de plateforme correspond à l’une des propriétés nommées ci-dessous (par exemple GTK) se résout correctement au moment de l’exécution. La correspondance respecte la casse (ordinal, par DevicePlatform égalité), de sorte que l’identificateur doit correspondre exactement à la casse du nom de propriété , un rapport DevicePlatform.Create("gtk")back-end (minuscules) ne correspond pas à la GTK propriété et passe à Default. Notez que l’optimisation au moment de la compilation (SimplifyOnPlatformVisitor) reconnaît uniquement les/-macos-maccatalyst-ios//-android frameworks cibles ; tous les autres frameworks cibles (y compris -windows et -tizen) et tout back-end personnalisé revient à la résolution du runtime.

Étant donné qu’une extension de balisage XAML mappe chaque argument nommé à une propriété CLR, le formulaire inline {OnPlatform iOS=…, Android=…} ne peut exprimer que les plateformes exposées sous forme de propriétés ici. Pour cibler une plateforme personnalisée arbitraire (par exemple, un rapport DevicePlatform.Create("Web")principal), utilisez le formulaire d’élément, qui accepte n’importe quelle chaîne de plateforme :

<OnPlatform x:TypeArguments="x:String">
    <On Platform="Web" Value="…" />
    <On Platform="iOS, Android" Value="…" />
</OnPlatform>

Constructeurs

Nom Description
OnPlatformExtension()

Fournit une extension de balisage XAML qui retourne des valeurs différentes en fonction de la plateforme sur laquelle l’application s’exécute.

Propriétés

Nom Description
Android

Obtient ou définit la valeur à utiliser sur Android.

Converter

Obtient ou définit un convertisseur à appliquer à la valeur spécifique à la plateforme.

ConverterParameter

Obtient ou définit un paramètre à passer au convertisseur.

Default

Obtient ou définit la valeur par défaut à utiliser si aucune valeur spécifique à la plateforme n’est définie.

GTK

Obtient ou définit la valeur à utiliser sur GTK.

iOS

Obtient ou définit la valeur à utiliser sur iOS.

MacCatalyst

Obtient ou définit la valeur à utiliser sur Mac Catalyst.

macOS

Obtient ou définit la valeur à utiliser sur macOS.

Tizen

Obtient ou définit la valeur à utiliser sur Tizen.

UWP
Obsolète.

Obtient ou définit la valeur à utiliser sur UWP. Utilisez WinUI à la place.

WinUI

Obtient ou définit la valeur à utiliser sur Windows (WinUI).

WPF

Obtient ou définit la valeur à utiliser sur WPF.

Méthodes

Nom Description
ProvideValue(IServiceProvider)

Fournit une extension de balisage XAML qui retourne des valeurs différentes en fonction de la plateforme sur laquelle l’application s’exécute.

S’applique à