OnPlatformExtension Klasse

Definition

Stellt eine XAML-Markuperweiterung bereit, die je nach Plattform, auf der die App ausgeführt wird, unterschiedliche Werte zurückgibt.

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
Vererbung
OnPlatformExtension
Attribute
Implementiert

Hinweise

Der Wert wird aufgelöst, indem der Platform Bezeichner (der Wert der DevicePlatform Struktur ToString() ) mit den Plattformwerten übereinstimmt. Daher wird ein benutzerdefiniertes Back-End, dessen Plattformzeichenfolge mit einer der unten genannten Eigenschaften übereinstimmt (z GTK. B. ) zur Laufzeit ordnungsgemäß aufgelöst. Bei der Übereinstimmung wird die Groß-/Kleinschreibung beachtet (Ordnungszahl pro DevicePlatform Gleichheit), sodass der Bezeichner genau mit der Groß-/Kleinschreibung des Eigenschaftsnamens übereinstimmen muss – eine Back-End-Berichterstellung DevicePlatform.Create("gtk") (Kleinbuchstabe) stimmt nicht mit der GTK Eigenschaft überein und fällt in .Default Beachten Sie, dass die Kompilierungszeitoptimierung (SimplifyOnPlatformVisitor) derzeit nur die/-macos-maccatalyst-ios//-android Zielframeworks erkennt. Jedes andere Zielframework (einschließlich -windows und -tizen) und jedes benutzerdefinierte Back-End fällt auf die Laufzeitauflösung zurück.

Da eine XAML-Markuperweiterung jedes benannte Argument einer CLR-Eigenschaft zuordnet, kann das Inlineformular {OnPlatform iOS=…, Android=…} nur die plattformen ausdrücken, die hier als Eigenschaften verfügbar gemacht werden. Um eine beliebige benutzerdefinierte Plattform (z. B. eine Back-End-Berichterstellung DevicePlatform.Create("Web")) als Ziel zu verwenden, verwenden Sie das Elementformular, das eine beliebige Plattformzeichenfolge akzeptiert:

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

Konstruktoren

Name Beschreibung
OnPlatformExtension()

Stellt eine XAML-Markuperweiterung bereit, die je nach Plattform, auf der die App ausgeführt wird, unterschiedliche Werte zurückgibt.

Eigenschaften

Name Beschreibung
Android

Dient zum Abrufen oder Festlegen des Werts, der unter Android verwendet werden soll.

Converter

Dient zum Abrufen oder Festlegen eines Konverters, der auf den plattformspezifischen Wert angewendet werden soll.

ConverterParameter

Dient zum Abrufen oder Festlegen eines Parameters, der an den Konverter übergeben werden soll.

Default

Ruft den zu verwendenden Standardwert ab, wenn kein plattformspezifischer Wert festgelegt ist, oder legt diesen fest.

GTK

Dient zum Abrufen oder Festlegen des Werts, der für GTK verwendet werden soll.

iOS

Dient zum Abrufen oder Festlegen des Werts, der für iOS verwendet werden soll.

MacCatalyst

Dient zum Abrufen oder Festlegen des Werts, der für Mac Catalyst verwendet werden soll.

macOS

Dient zum Abrufen oder Festlegen des Werts, der unter macOS verwendet werden soll.

Tizen

Dient zum Abrufen oder Festlegen des Werts, der für Tizen verwendet werden soll.

UWP
Veraltet.

Dient zum Abrufen oder Festlegen des Werts, der für UWP verwendet werden soll. Verwenden Sie stattdessen WinUI.

WinUI

Dient zum Abrufen oder Festlegen des Werts, der unter Windows (WinUI) verwendet werden soll.

WPF

Dient zum Abrufen oder Festlegen des Werts, der für WPF verwendet werden soll.

Methoden

Name Beschreibung
ProvideValue(IServiceProvider)

Stellt eine XAML-Markuperweiterung bereit, die je nach Plattform, auf der die App ausgeführt wird, unterschiedliche Werte zurückgibt.

Gilt für: