OnPlatformExtension Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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. |