CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options ermöglicht Entwicklern, CommunityToolkit.Maui anzupassen. Das Toolkit verhält sich möglicherweise anders, hängt von diesen Einstellungen ab.

Options sollte beim Starten beim Aufruf von .UseMauiCommunityToolkit() zugewiesen werden:

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

SetShouldSuppressExceptionsInConverters

Wenn auf true festgelegt, wird bei einem Konverter, der CommunityToolkit.Maui.Converters.BaseConverter implementiert, eine Exception auslöst, die Exception abgefangen, über Debug.WriteLine() protokolliert und ein vordefinierter Standardwert zurückgegeben.

Der Standardwert ist false.

Example

Diese Option ist beim Aufrufen .UseMauiCommunityToolkit()aktiviert:

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

Standardrückgabewerte

Wenn auf true festgelegt, wird ein Standardwert zurückgegeben, wenn ein Converter eine Exception auslöst.

Zwei Standardwerte sind enthalten:

• public object? ICommunityToolkitValueConverter.DefaultConvertReturnValue { get; set; }
  • Default value returned when Convert(object? value, Type targetType, object? parameter, CultureInfo? culture) löst einen Exception
• public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
  • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) löst eine Exception aus

Hier ist ein Beispiel zum Festlegen der Standardwerte 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

Wenn die Einstellung auf true gesetzt ist und ein Animation, das CommunityToolkit.Maui.Behaviors.AnimationBehavior implementiert, ein Exception auslöst, wird das Exception abgefangen und über Debug.WriteLine() protokolliert.

Der Standardwert ist false.

Example

Diese Option ist beim Aufrufen .UseMauiCommunityToolkit()aktiviert:

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

SetShouldSuppressExceptionsInBehaviors

Wenn true festgelegt ist und ein Behavior, das CommunityToolkit.Maui.Behaviors.BaseBehavior implementiert, ein Exception auslöst, wird das Exception abgefangen und über Debug.WriteLine() protokolliert.

Der Standardwert ist false.

Example

Diese Option ist beim Aufrufen .UseMauiCommunityToolkit()aktiviert:

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