Partager via

CommunityToolkit.Maui.Options

  • Article

CommunityToolkit.Maui.Options permet aux développeurs de personnaliser CommunityToolkit.Maui. Le kit de ressources peut se comporter différemment en fonction de ces paramètres.

Options doit être affecté au démarrage lors de l’appel de .UseMauiCommunityToolkit() :

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

SetShouldSuppressExceptionsInConverters

Lorsqu’il est défini sur true, si un convertisseur qui implémente CommunityToolkit.Maui.Converters.BaseConverter lève un Exception, le Exception sera intercepté, journalisé via Debug.WriteLine() et une valeur par défaut prédéterminée sera retournée.

La valeur par défaut est false.

Exemple

Cette option est activée lors de l’appel de .UseMauiCommunityToolkit() :

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

Valeurs de retour par défaut

Lorsqu’elle est définie sur true, une valeur par défaut est retournée lorsqu’un Converter lève un Exception.

Deux valeurs par défaut sont incluses :

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

Voici un exemple définissant les valeurs par défaut pour 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

Lorsqu’elle est définie sur true, si un Animation qui implémente CommunityToolkit.Maui.Behaviors.AnimationBehavior lève un Exception, le Exception sera intercepté et sera journalisé via Debug.WriteLine().

La valeur par défaut est false.

Exemple

Cette option est activée lors de l’appel de .UseMauiCommunityToolkit() :

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

SetShouldSuppressExceptionsInBehaviors

Lorsqu’elle est définie sur true, si Behavior qui implémente CommunityToolkit.Maui.Behaviors.BaseBehavior lève un Exception, le Exception sera intercepté et sera journalisé via Debug.WriteLine().

La valeur par défaut est false.

Exemple

Cette option est activée lors de l’appel de .UseMauiCommunityToolkit() :

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