CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options memungkinkan pengembang untuk menyesuaikan CommunityToolkit.Maui. Toolkit mungkin berprilaku berbeda tergantung pada pengaturan ini.

Options harus ditetapkan saat startup saat memanggil .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInConverters

Ketika diatur ke true, jika pengonversi yang menerapkan CommunityToolkit.Maui.Converters.BaseConverter melempar Exception, Exception akan ditangkap, dicatat melalui Debug.WriteLine(), dan nilai default yang telah ditentukan akan dikembalikan.

Nilai default false.

Contoh

Opsi ini diaktifkan saat memanggil .UseMauiCommunityToolkit():

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

Nilai Pengembalian Default

Saat diatur ke true, nilai default akan dikembalikan saat melempar ConverterException.

Dua nilai default disertakan:

• public object? ICommunityToolkitValueConverter.DefaultConvertReturnValue { get; set; }
  • Default value returned when Convert(object? value, Type targetType, object? parameter, CultureInfo? culture) melempar Exception
• public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
  • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) melempar Exception

Berikut adalah contoh pengaturan nilai default untuk 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

Ketika diatur ke true, jika penerapan AnimationCommunityToolkit.Maui.Behaviors.AnimationBehavior melempar Exception, Exception akan tertangkap dan akan dicatat melalui Debug.WriteLine().

Nilai default false.

Contoh

Opsi ini diaktifkan saat memanggil .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInBehaviors

Ketika diatur ke true, jika Behavior penerapan CommunityToolkit.Maui.Behaviors.BaseBehavior melempar Exception, Exception akan tertangkap dan akan dicatat melalui Debug.WriteLine().

Nilai default false.

Contoh

Opsi ini diaktifkan saat memanggil .UseMauiCommunityToolkit():

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