CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options umożliwia deweloperom dostosowywanie CommunityToolkit.Mauielementu . Zestaw narzędzi może zachowywać się inaczej, zależy od tych ustawień.

Options należy przypisać podczas uruchamiania podczas wywoływania elementu .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInConverters

Po ustawieniu truewartości na wartość , jeśli implementowanie konwertera CommunityToolkit.Maui.Converters.BaseConverterExceptionzgłasza błąd , Exception zostanie przechwycony, zarejestrowany za pośrednictwem Debug.WriteLine()metody i zostanie zwrócona wstępnie określona wartość domyślna.

Wartość domyślna to false.

Przykład

Ta opcja jest włączona podczas wywoływania polecenia .UseMauiCommunityToolkit():

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

Domyślne wartości zwracane

Po ustawieniu wartości na truewartość wartość domyślna zostanie zwrócona, gdy Converter element zgłasza Exceptionwartość .

Uwzględniane są dwie wartości domyślne:

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

Oto przykład ustawienia wartości domyślnych dla elementu 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

W przypadku ustawienia truewartości , jeśli implementacja AnimationCommunityToolkit.Maui.Behaviors.AnimationBehavior zgłasza błąd Exception, Exception element zostanie przechwycony i zostanie zarejestrowany za pomocą polecenia Debug.WriteLine().

Wartość domyślna to false.

Przykład

Ta opcja jest włączona podczas wywoływania polecenia .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInBehaviors

W przypadku ustawienia wartości true, jeśli implementacja CommunityToolkit.Maui.Behaviors.BaseBehaviorBehavior zgłasza błąd Exception, Exception element zostanie przechwycony i zostanie zarejestrowany za pomocą polecenia Debug.WriteLine().

Wartość domyślna to false.

Przykład

Ta opcja jest włączona podczas wywoływania polecenia .UseMauiCommunityToolkit():

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