CommunityToolkit.Maui.Options

CommunityToolkit.Maui.Options ermöglicht Fachkräfte für Entwicklung das Anpassen von CommunityToolkit.Maui. Das Toolkit kann sich je nach diesen Einstellungen unterschiedlich verhalten.

Options sollte beim Start zugewiesen werden, wenn .UseMauiCommunityToolkit() aufgerufen wird:

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

SetShouldSuppressExceptionsInConverters

Wenn true eingestellt ist und ein Konverter, der CommunityToolkit.Maui.Converters.BaseConverter implementiert, ein Exception auslöst, wird Exception abgefangen, über Debug.WriteLine() protokolliert und ein vorgegebener Standardwert zurückgegeben.

Der Standardwert ist false.

Beispiel

Diese Option ist beim Aufrufen von .UseMauiCommunityToolkit() aktiviert:

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

Standardmäßige Rückgabewerte

Ist der Wert auf true gesetzt, wird ein Standardwert zurückgegeben, wenn Converter ein 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 aus
• public object ICommunityToolkitValueConverter.DefaultConvertBackReturnValue { get; set; }
  • Default value returned when ConvertBack(object? value, Type targetType, object? parameter, CultureInfo? culture) löst einen 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

Bei Festlegung auf true, wenn eine Animation-Implementierung CommunityToolkit.Maui.Behaviors.AnimationBehavior einen Exception auslöst, wird Exception abgefangen und über Debug.WriteLine() protokolliert.

Der Standardwert ist false.

Beispiel

Diese Option ist beim Aufrufen von .UseMauiCommunityToolkit() aktiviert:

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

SetShouldSuppressExceptionsInBehaviors

Bei Festlegung auf true, wenn eine Behavior-Implementierung CommunityToolkit.Maui.Behaviors.BaseBehavior einen Exception auslöst, wird Exception abgefangen und über Debug.WriteLine() protokolliert.

Der Standardwert ist false.

Beispiel

Diese Option ist beim Aufrufen von .UseMauiCommunityToolkit() aktiviert:

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