BoolToObjectConverter

Článek
11/11/2023

Jedná se BoolToObjectConverter o převaděč, který umožňuje uživatelům převést bool vazbu hodnot na konkrétní objekt. Poskytnutím TrueObject a FalseObject v převaděči bude vrácen příslušný objekt v závislosti na hodnotě vazby.

Metoda Convert vrátí TrueObject , pokud je zadaný value nebo trueFalseObject jinak.

Metoda ConvertBack vrátí true , pokud je zadaná value hodnota rovna TrueObject nebo false jinak.

BaseConverter – vlastnosti

V základní třídě jsou implementovány následující vlastnosti: public abstract class BaseConverter

Vlastnost	Popis
`DefaultConvertReturnValue`	Výchozí hodnota, která se má vrátit při `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .
`DefaultConvertBackReturnValue`	Výchozí hodnota, která se má vrátit při `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .

ICommunityToolkitValueConverter – vlastnosti

Následující vlastnosti jsou implementovány v public interface ICommunityToolkitValueConverter:

Vlastnost	Type	Popis
`DefaultConvertReturnValue`	`object?`	Výchozí hodnota, která se má vrátit při `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .
`DefaultConvertBackReturnValue`	`object?`	Výchozí hodnota, která se má vrátit při `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .

Syntaxe

Následující příklady ukazují, jak použít BoolToObjectConverter ke změně pozadí Entry ovládacího prvku na základě konkrétní hodnoty vázané vlastnosti IsValid je true nebo false.

XAML

Zahrnutí oboru názvů XAML

Pokud chcete použít sadu nástrojů v XAML, musíte do stránky nebo zobrazení přidat následující xmlns položky:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Proto platí následující:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Bylo by změněno tak, aby zahrnovalo xmlns následující:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Použití BoolToObjectConverter

V XAML je možné ho BoolToObjectConverter použít následujícím způsobem:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.BoolToObjectConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
            <SolidColorBrush x:Key="TrueColorBrush">Green</SolidColorBrush>
            <SolidColorBrush x:Key="FalseColorBrush">Red</SolidColorBrush>

            <toolkit:BoolToObjectConverter x:Key="IsValidConverter" 
                TrueObject="{StaticResource TrueColorBrush}" 
                FalseObject="{StaticResource FalseColorBrush}"/>
        </ResourceDictionary>
    </ContentPage.Resources>

    <Entry Background="{Binding IsValid, Converter={StaticResource IsValidConverter}}" />

</ContentPage>

C#

V BoolToObjectConverter jazyce C# je možné ho použít následujícím způsobem:

class BoolToObjectConverterPage : ContentPage
{
    public BoolToObjectConverterPage()
    {
        var entry = new Entry();

        label.SetBinding(
            Label.IsVisibleProperty,
            new Binding(
                nameof(ViewModels.IsValid),
                converter: new BoolToObjectConverter
                {
                    TrueObject = new SolidColorBrush(Colors.Green),
                    FalseObject = new SolidColorBrush(Colors.Red)
                }));

        Content = label;
    }
}

Revize jazyka C#

Náš CommunityToolkit.Maui.Markup balíček nabízí mnohem stručnější způsob použití tohoto převaděče v jazyce C#.

using CommunityToolkit.Maui.Markup;

class BoolToObjectConverterPage : ContentPage
{
    public BoolToObjectConverterPage()
    {
        Content = new Entry()
            .Bind(
                Label.BackgroundProperty,
                static (ViewModel vm) => vm.IsValid,
                converter: new BoolToObjectConverter
                {
                    TrueObject = new SolidColorBrush(Colors.Green),
                    FalseObject = new SolidColorBrush(Colors.Red)
                });
    }
}

Příklady

Příklad tohoto převaděče najdete v akci v ukázkové aplikaci .NET MAUI Community Toolkit.

rozhraní API

Zdrojový kód BoolToObjectConverter najdete v úložišti .NET MAUI Community Toolkit na GitHubu.

Sdílet prostřednictvím