CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options permite aos programadores personalizar CommunityToolkit.Maui. O conjunto de ferramentas pode comportar-se de forma diferente dependendo dessas definições.

Options deve ser atribuído no arranque ao ligar .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInConverters

Quando definido para true, se um conversor que implementa CommunityToolkit.Maui.Converters.BaseConverter lançar um Exception, o Exception será capturado, registado através de Debug.WriteLine() e será devolvido um valor predefinido.

O valor predefinido é false.

Example

Esta opção está ativada ao ligar .UseMauiCommunityToolkit():

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

Valores de retorno padrão

Quando definido para true, um valor padrão será devolvido quando um Converter lança um Exception.

Estão incluídos dois valores por defeito:

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

Aqui está um exemplo que define os valores padrão para 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

Quando definido para true, se um(a) Animation que implemente CommunityToolkit.Maui.Behaviors.AnimationBehavior lançar um(a) Exception, o(a) Exception será capturado(a) e registado(a) através de Debug.WriteLine().

O valor predefinido é false.

Example

Esta opção está ativada ao ligar .UseMauiCommunityToolkit():

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

DefinirDeveSuprimirExceçõesEmComportamentos

Quando definido para true, se uma Behavior que implemente CommunityToolkit.Maui.Behaviors.BaseBehavior lançar um Exception, o Exception será capturado e registado através de Debug.WriteLine().

O valor predefinido é false.

Example

Esta opção está ativada ao ligar .UseMauiCommunityToolkit():

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