CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options gör det möjligt för utvecklare att anpassa CommunityToolkit.Maui. Verktygslådan kan bete sig annorlunda beroende på de här inställningarna.

Options bör tilldelas vid start när du anropar .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInConverters

När detta är inställt på true kommer Exception att fångas och loggas via Debug.WriteLine(), och ett förutbestämt standardvärde returneras om en konverterare som implementerar CommunityToolkit.Maui.Converters.BaseConverter kastar Exception.

Standardvärdet är false.

Example

Det här alternativet är aktiverat när du anropar .UseMauiCommunityToolkit():

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

Standardreturvärden

När detta är inställt på true returneras ett standardvärde när en Converter utlöser ett Exception.

Två standardvärden ingår:

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

Här är ett exempel som anger standardvärdena för 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

När detta är inställt på true, om en Animation som implementerar CommunityToolkit.Maui.Behaviors.AnimationBehavior utlöser ett Exception, kommer Exception att fångas och loggas via Debug.WriteLine().

Standardvärdet är false.

Example

Det här alternativet är aktiverat när du anropar .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInBehaviors

När detta är inställt på true, om en Behavior som implementerar CommunityToolkit.Maui.Behaviors.BaseBehavior kastar ett Exception, kommer Exception att fångas och loggas via Debug.WriteLine().

Standardvärdet är false.

Example

Det här alternativet är aktiverat när du anropar .UseMauiCommunityToolkit():

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