CommunityToolkit.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 변환기가 throw ExceptionException 되면 catch되고, 로깅되며Debug.WriteLine(), 미리 결정된 기본값이 반환됩니다.

기본값은 false여야 합니다.

예시

이 옵션은 다음을 호출 .UseMauiCommunityToolkit()할 때 사용하도록 설정됩니다.

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

기본 반환 값

로 true설정하면 기본값이 throw될 때 Converter 반환됩니다 Exception.

다음 두 가지 기본값이 포함됩니다.

  • public object? ICommunityToolkitValueConverter.DefaultConvertReturnValue { get; set; }
    • Default value returned when Convert(object? value, Type targetType, object? parameter, CultureInfo? culture) Throw Exception
  • public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
    • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) Throw 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 throw ExceptionException 되는 CommunityToolkit.Maui.Behaviors.AnimationBehavior 경우 catch되고 이를 통해 Debug.WriteLine()로깅됩니다.

기본값은 false여야 합니다.

예시

이 옵션은 다음을 호출 .UseMauiCommunityToolkit()할 때 사용하도록 설정됩니다.

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

SetShouldSuppressExceptionsInBehaviors

로 설정true하면 구현에서 Behavior throw ExceptionException 되는 CommunityToolkit.Maui.Behaviors.BaseBehavior 경우 catch되고 이를 통해 Debug.WriteLine()로깅됩니다.

기본값은 false여야 합니다.

예시

이 옵션은 다음을 호출 .UseMauiCommunityToolkit()할 때 사용하도록 설정됩니다.

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