CommunityToolkit.Maui.Options

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

Options doit être affecté au démarrage lors de l’appel .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 implémentant CommunityToolkit.Maui.Converters.BaseConverter lance une Exception, l’Exception sera interceptée, journalisée via Debug.WriteLine(), et une valeur par défaut prédéterminée sera renvoyée.

La valeur par défaut est false.

Example

Cette option est activée lors de l’appel .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 sera renvoyée lorsqu’un Converter lève une exception 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 une Exception
• public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
  • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) génère une 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’il est défini sur true, si un Animation qui implémente CommunityToolkit.Maui.Behaviors.AnimationBehavior lève un Exception, le Exception sera intercepté et consigné dans les journaux via Debug.WriteLine().

La valeur par défaut est false.

Example

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

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

SetShouldSuppressExceptionsInBehaviors

Lorsqu’elle est définie sur true, si un(e) Behavior implémentant CommunityToolkit.Maui.Behaviors.BaseBehavior déclenche un(e) Exception, le/la Exception sera intercepté(e) et journalisé(e) via Debug.WriteLine().

La valeur par défaut est false.

Example

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

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