MultiMathExpressionConverter

MultiMathExpressionConverter ist ein Konverter, mit dem Benutzer verschiedene mathematische Vorgänge mit mehreren Werten mithilfe von MultiBinding konvertieren können.

Mit Convert wird die Ausdruckszeichenfolge berechnet, die im ConverterParameter mit mehreren Variablen definiert ist, und es wird ein Ergebnis vom Typ double zurückgegeben.

Die Werte, die an den Konverter übergeben werden, erhalten den Namen x?where? ist die Reihenfolge, in der sie im MultiBinding definiert ist, alle anderen Variablennamen im Ausdruck werden ignoriert. Um beispielsweise die Berechnung von P = V * I (Potenz = Volt * amp) auszudrücken, kann Folgendes geschrieben werden:

<Label.Text>
    <MultiBinding Converter="{StaticResource MultiMathExpressionConverter}" ConverterParameter="x0 * x1">
        <Binding Path="Volts" />
        <Binding Path="Amps" />
    </MultiBinding>
</Label.Text>

Syntax

Die folgenden Beispiele zeigen, wie Sie eine Label hinzufügen, die das Ergebnis von x0 + x1 + x2 zeigt, wobei die x-Werte in der Reihenfolge der MultiBinding-Definitionen angegeben werden.

XAML

Einbinden des XAML-Namespace

Um das Toolkit in XAML verwenden zu können, muss der folgende xmlns-Abschnitt zu Ihrer Seite oder Ansicht hinzugefügt werden:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Der folgende Abschnitt:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Würde dann geändert werden, um xmlns einzubinden:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Verwenden des MultiMathExpressionConverter

MultiMathExpressionConverter kann wie folgt in XAML verwendet werden:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.MultiMathExpressionConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:MultiMathExpressionConverter x:Key="MultiMathExpressionConverter" />
        </ResourceDictionary>
    </ContentPage.Resources>

    <Label HorizontalOptions="Center">
        <Label.Text>
            <MultiBinding Converter="{StaticResource MultiMathExpressionConverter}" ConverterParameter="x0 + x1 + x2">
                <Binding Path="X0" />
                <Binding Path="X1" />
                <Binding Path="X2" />
            </MultiBinding>
        </Label.Text>
    </Label>

</ContentPage>

C#

MultiMathExpressionConverter kann wie folgt in C# verwendet werden:

class MultiMathExpressionConverterPage : ContentPage
{
    public MultiMathExpressionConverterPage()
    {
        var label = new Label
        {
            HorizontalOptions = LayoutOptions.Center
        };

        label.SetBinding(
            Label.TextProperty,
            new MultiBinding
            {
                Converter = new MultiMathExpressionConverter(),
                ConverterParameter = "x0 + x1 + x2",
                Bindings = new List<BindingBase>
                {
                    new Binding(static (ViewModel vm) => vm.X0),
                    new Binding(static (ViewModel vm) => vm.X1),
                    new Binding(static (ViewModel vm) => vm.X2)
                }
            });

        Content = label;
    }
}

C#-Markup

Das Paket CommunityToolkit.Maui.Markup bietet eine viel präzisere Möglichkeit, diesen Konverter in C# zu verwenden.

class MultiMathExpressionConverterPage : ContentPage
{
    public MultiMathExpressionConverterPage()
    {
        Content = new Label()
            .CenterHorizontal()
            .Bind(
                Label.TextProperty,
                new List<BindingBase>
                {
                    new Binding(static (ViewModel vm) => vmX0),
                    new Binding(static (ViewModel vm) => vmX1),
                    new Binding(static (ViewModel vm) => vmX2)
                },
                converter: new MultiMathExpressionConverter(),
                converterParameter: "x0 + x1 + x2");
    }
}

Unterstützte Vorgänge

Die folgenden Operationen werden unterstützt:

• "+"
• "-"
• "*"
• "/"
• "%"
• "abs"
• "acos"
• "asin"
• "atan"
• "atan2"
• "ceiling"
• "cos"
• "cosh"
• "exp"
• "floor"
• "ieeeremainder"
• „log“
• "log10"
• "max"
• "min"
• "pow"
• "round"
• "sign"
• "sin"
• "sinh"
• "sqrt"
• "tan"
• "tanh"
• "truncate"
• "^"
• "pi"
• "e"

Beispiele

Ein Beispiel für diesen Konverter in Aktion finden Sie in der Beispielanwendung für das .NET MAUI Community Toolkit.

API

Sie finden den Quellcode für MultiMathExpressionConverter über das GitHub-Repository für das .NET MAUI Community Toolkit.