CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options stelt ontwikkelaars in staat om aan te passen CommunityToolkit.Maui. De toolkit werkt mogelijk anders, afhankelijk van deze instellingen.

Options moet tijdens het opstarten worden toegewezen bij het aanroepen van .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInConverters

Wanneer ingesteld op true, wordt de Exception opgevangen en via Debug.WriteLine() gelogd als een converter die CommunityToolkit.Maui.Converters.BaseConverter implementeert een Exception genereert, en wordt een vooraf bepaalde standaardwaarde geretourneerd.

De standaardwaarde is false.

Example

Deze optie is ingeschakeld bij het aanroepen .UseMauiCommunityToolkit():

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

Standaardwaarden voor retour

Als deze waarde is ingesteld op true, wordt een standaardwaarde geretourneerd wanneer een Converter een Exception genereert.

Er zijn twee standaardwaarden opgenomen:

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

Hier volgt een voorbeeld van het instellen van de standaardwaarden voor 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

Wanneer deze optie is ingesteld op true, als een Animation implementatie CommunityToolkit.Maui.Behaviors.AnimationBehavior een Exceptionwerpt, wordt de Exception betrapt en zal worden geregistreerd via Debug.WriteLine().

De standaardwaarde is false.

Example

Deze optie is ingeschakeld bij het aanroepen .UseMauiCommunityToolkit():

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

SetShouldSuppressExceptionsInBehaviors

Wanneer ingesteld op true, wordt, als een Behavior dat CommunityToolkit.Maui.Behaviors.BaseBehavior implementeert een Exception veroorzaakt, de Exception opgevangen en gelogd via Debug.WriteLine().

De standaardwaarde is false.

Example

Deze optie is ingeschakeld bij het aanroepen .UseMauiCommunityToolkit():

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