CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options を使用すると、開発者は CommunityToolkit.Mauiをカスタマイズできます。 ツールキットの動作は、これらの設定によって異なる場合があります。

Options .UseMauiCommunityToolkit()を呼び出すときに起動時に割り当てる必要があります。

var builder = MauiApp.CreateBuilder();
builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
})

SetShouldSuppressExceptionsInConverters

trueに設定すると、CommunityToolkit.Maui.Converters.BaseConverterを実装するコンバーターがExceptionをスローすると、Exceptionがキャッチされ、Debug.WriteLine()経由でログに記録され、事前に定義された既定値が返されます。

既定値は、false です。

Example

このオプションは、 .UseMauiCommunityToolkit()を呼び出すときに有効になります。

var builder = MauiApp.CreateBuilder();
builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(true);
})

既定の戻り値

trueに設定すると、ConverterがExceptionをスローしたときに既定値が返されます。

次の 2 つの既定値が含まれています。

  • public object? ICommunityToolkitValueConverter.DefaultConvertReturnValue { get; set; }
    • Default value returned when Convert(object? value, Type targetType, object? parameter, CultureInfo? culture) は Exception をスローします
  • public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
    • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) は Exception をスローします

BoolToObjectConverterの既定値の設定例を次に示します。

XAML

<ContentPage.Resources>
    <SolidColorBrush x:Key="TrueColorBrush">Green</SolidColorBrush>
    <SolidColorBrush x:Key="FalseColorBrush">Red</SolidColorBrush>
    <toolkit:BoolToObjectConverter x:Key="BoolToColorBrushConverter" 
                                TrueObject="{StaticResource TrueColorBrush}" 
                                FalseObject="{StaticResource FalseColorBrush}"
                                DefaultConvertReturnValue="{StaticResource FalseColorBrush}"
                                DefaultConvertBackReturnValue="False"/>
</ContentPage.Resources>

C#

var boolToColorBrushConverter = new BoolToObjectConverter
{
    TrueObject = new SolidColorBrush(Colors.Green),
    FalseObject = new SolidColorBrush(Colors.Red),
    DefaultConvertReturnValue = new SolidColorBrush(Colors.Red),
    DefaultConvertBackReturnValue = false
};

SetShouldSuppressExceptionsInAnimations

trueに設定すると、Animationを実装するCommunityToolkit.Maui.Behaviors.AnimationBehaviorがExceptionをスローすると、Exceptionがキャッチされ、Debug.WriteLine()経由でログに記録されます。

既定値は、false です。

Example

このオプションは、 .UseMauiCommunityToolkit()を呼び出すときに有効になります。

var builder = MauiApp.CreateBuilder();
builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInAnimations(true);
})

動作において例外を抑制するかどうかを設定する

trueに設定すると、Behaviorを実装するCommunityToolkit.Maui.Behaviors.BaseBehaviorがExceptionをスローすると、Exceptionがキャッチされ、Debug.WriteLine()経由でログに記録されます。

既定値は、false です。

Example

このオプションは、 .UseMauiCommunityToolkit()を呼び出すときに有効になります。

var builder = MauiApp.CreateBuilder();
builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInBehaviors(true);
})
  • Last updated on