.NET MAUI コンバーター

.NET マルチプラットフォーム アプリ UI (.NET MAUI) データ バインディングは、通常、ソース プロパティからターゲット プロパティにデータを転送し、場合によってはターゲット プロパティからソース プロパティにデータを転送します。 この転送は、ソースプロパティとターゲットプロパティが同じ型の場合、または暗黙的な変換によって一方の型を他の型に変換できる場合に簡単です。 そうでない場合は、型変換を行う必要があります。

コンバーターの詳細については、.NET MAUIドキュメントを参照してください。

.NET MAUI Community Toolkit コンバーター

.NET MAUI Community Toolkit には、開発者の生活を容易にするために、事前に構築された再利用可能なコンバーターのコレクションが用意されています。 ツールキットによって提供されるコンバーターを次に示します。

.NET MAUI Community Toolkit Converter を作成する

.NET MAUI Community Toolkit では、.NET MAUIによって提供される IValueConverter インターフェイスの型セーフな実装が提供されるため、開発者はより簡潔でタイプ セーフなコンバーターを簡単に記述できます。 ツールキットには、次のオプションが用意されています

双方向コンバーター

BaseConverter クラスを使用すると、開発者は受信値の型と、双方向バインディングをサポートするIValueConverter実装の送信値の型を定義できます。 次の例は、bool値をColors.Green場合はtrueに変換し、Colors.Red場合はfalseするコンバーターを作成する方法を示しています。

public class BoolToColorConverter : BaseConverter<bool, Color>
{
    public override Color DefaultConvertReturnValue { get; set; } = Colors.Orange;

    public override bool DefaultConvertBackReturnValue { get; set; } = false;

    public override string ConvertFrom(bool value, CultureInfo? culture)
    {
        return value ? Colors.Green : Colors.Red;
    }

    public override int ConvertBackTo(Color value, CultureInfo? culture)
    {
        return value == Colors.Green;
    }
}

DefaultConvertReturnValue は基本実装で使用され、ConvertFrom メソッド内で例外がスローされると返されます。

DefaultConvertBackReturnValue はベース実装で使用され、ConvertBackTo メソッド内で例外がスローされたときに返されます。

一方向コンバーター

BaseConverterOneWay クラスを使用すると、開発者は、受信値の型と、一方向のバインドをサポートするIValueConverter実装の送信値の型を定義できます。 次の例は、bool値をColors.Green場合はtrueに変換し、Colors.Red場合はfalseするコンバーターを作成する方法を示しています。

public class BoolToColorConverter : BaseConverterOneWay<bool, Color>
{
    public override Color DefaultConvertReturnValue { get; set; } = Colors.Orange

    public override string ConvertFrom(bool value, CultureInfo? culture)
    {
        return value ? Colors.Green : Colors.Red;
    }
}

DefaultConvertReturnValue は基本実装で使用され、ConvertFrom メソッド内で例外がスローされた場合は返されます。