CommunityToolkit.Maui.Options
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 unException
public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture)
lève unException
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);
})
.NET MAUI Community Toolkit
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour