Поделиться через

Сообщество набор средств. Maui.Options

  • Статья

CommunityToolkit.Maui.Options позволяет разработчикам настраивать CommunityToolkit.Maui. Набор средств может вести себя по-разному в зависимости от этих параметров.

Options при вызове должно быть назначено при запуске .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInConverters

trueЕсли преобразователь, реализующий CommunityToolkit.Maui.Converters.BaseConverter исключениеException, Exception будет поймано, вошедшего в системуDebug.WriteLine(), и будет возвращено предопределенное значение по умолчанию.

Значение по умолчанию: false.

Пример

Этот параметр включен при вызове .UseMauiCommunityToolkit():

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

Возвращаемые значения по умолчанию

Если задано значение true, значение по умолчанию будет возвращено при Converter вызове Exceptionобъекта.

Включены два значения по умолчанию:

  • public object? ICommunityToolkitValueConverter.DefaultConvertReturnValue { get; set; }
    • Default value returned when Convert(object? value, Type targetType, object? parameter, CultureInfo? culture) вызывает исключение Exception
  • public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
    • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) вызывает исключение Exception

Ниже приведен пример настройки значений по умолчанию для 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

Если задано значение true, если Animation реализация CommunityToolkit.Maui.Behaviors.AnimationBehavior создает исключение Exception, Exception оно будет поймано и будет зарегистрировано через Debug.WriteLine().

Значение по умолчанию: false.

Пример

Этот параметр включен при вызове .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInBehaviors

Если задано значение true, если Behavior реализация CommunityToolkit.Maui.Behaviors.BaseBehavior создает исключение Exception, Exception будет поймано и будет зарегистрировано через Debug.WriteLine().

Значение по умолчанию: false.

Пример

Этот параметр включен при вызове .UseMauiCommunityToolkit():

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