CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options geliştiricilerin öğesini özelleştirmesine CommunityToolkit.Mauiizin verir. Araç seti farklı davranabilir, bu ayarlara bağlıdır.

Options çağrılırken .UseMauiCommunityToolkit()başlangıçta atanmalıdır:

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

SetShouldSuppressExceptionsInConverters

olarak ayarlandığında true, uygulayan CommunityToolkit.Maui.Converters.BaseConverter bir dönüştürücü bir Exceptionoluşturursa , Exception yakalanacak, aracılığıyla Debug.WriteLine()günlüğe kaydedilir ve önceden belirlenmiş bir varsayılan değer döndürülür.

Varsayılan değer false olarak belirlenmiştir.

Örnek

Bu seçenek çağrılırken .UseMauiCommunityToolkit()etkinleştirilir:

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

Varsayılan Dönüş Değerleri

olarak trueayarlandığında, bir değeri attığında Converter varsayılan bir Exceptiondeğer döndürülür.

İki varsayılan değer eklenir:

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

Aşağıda için BoolToObjectConvertervarsayılan değerleri ayarlamaya yönelik bir örnek verilmiştir:

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

olarak trueayarlandığında, uygulayan CommunityToolkit.Maui.Behaviors.AnimationBehavior bir AnimationExceptionException oluşturursa yakalanacak ve aracılığıyla Debug.WriteLine()günlüğe kaydedilir.

Varsayılan değer false olarak belirlenmiştir.

Örnek

Bu seçenek çağrılırken .UseMauiCommunityToolkit()etkinleştirilir:

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

SetShouldSuppressExceptionsInBehaviors

olarak trueayarlandığında, uygulayan BehaviorCommunityToolkit.Maui.Behaviors.BaseBehavior bir ExceptionException atarsa yakalanacak ve aracılığıyla Debug.WriteLine()günlüğe kaydedilir.

Varsayılan değer false olarak belirlenmiştir.

Örnek

Bu seçenek çağrılırken .UseMauiCommunityToolkit()etkinleştirilir:

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