Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
VariableMultiValueConverter to konwerter, który umożliwia użytkownikom konwertowanie wartości bool za pośrednictwem MultiBinding do pojedynczego bool. Dzięki temu można określić, czy wartości All, Any, None lub określona liczba wartości są prawdziwe, jak określono w parametrze ConditionType.
Metoda Convert zwraca podany values, przekształcony w ogólny wynik bool na podstawie zdefiniowanego ConditionType.
Metoda ConvertBack zwróci wynik tylko wtedy, gdy ConditionType parametr ma wartość MultiBindingCondition.All.
Właściwości obiektu BaseConverter
Następujące właściwości są implementowane w klasie bazowej: public abstract class BaseConverter
| Majątek | Description |
|---|---|
DefaultConvertReturnValue |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true |
DefaultConvertBackReturnValue |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true |
Właściwości ICommunityToolkitValueConverter
Następujące właściwości są implementowane w pliku public interface ICommunityToolkitValueConverter:
| Majątek | Typ | Description |
|---|---|---|
DefaultConvertReturnValue |
object? |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true |
DefaultConvertBackReturnValue |
object? |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest używana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true |
Syntax
W poniższych przykładach pokazano, jak sprawić, aby element Label był niewidoczny, gdy co najmniej 2 wartości w MultiBinding dają wynik true.
XAML
Dołączanie przestrzeni nazw XAML
Aby można było używać zestawu narzędzi w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:
xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
Dlatego następuje:
<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>
Zostanie zmodyfikowana tak, aby zawierała następujące xmlns elementy:
<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>
Korzystanie ze zmiennej VariableMultiValueConverter
Elementu VariableMultiValueConverter można użyć w języku XAML w następujący sposób:
<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.VariableMultiValueConverterPage">
<ContentPage.Resources>
<ResourceDictionary>
<toolkit:VariableMultiValueConverter
x:Key="VariableMultiValueConverter"
ConditionType="LessThan"
Count="2" />
</ResourceDictionary>
</ContentPage.Resources>
<Label Text="At least 2 toppings must be selected.">
<Label.IsVisible>
<MultiBinding Converter="{StaticResource VariableMultiValueConverter}">
<Binding Path="IsCheeseSelected" />
<Binding Path="IsHamSelected" />
<Binding Path="IsPineappleSelected" />
</MultiBinding>
</Label.IsVisible>
</Label>
</ContentPage>
C#
Elementu VariableMultiValueConverter można użyć w następujący sposób w C#:
class VariableMultiValueConverterPage : ContentPage
{
public VariableMultiValueConverterPage()
{
var label = new Label
{
Text = "At least 2 toppings must be selected."
};
label.SetBinding(
Label.IsVisibleProperty,
new MultiBinding
{
Converter = new VariableMultiValueConverter
{
ConditionType = MultiBindingCondition.LessThan,
Count = 2
},
Bindings = new List<BindingBase>
{
new Binding(static (ViewModel vm) => vm.IsCheeseSelected),
new Binding(static (ViewModel vm) => vmIsHamSelected),
new Binding(static (ViewModel vm) => vmIsPineappleSelected)
}
});
Content = label;
}
}
Znaczniki języka C#
Nasz CommunityToolkit.Maui.Markup pakiet zapewnia znacznie bardziej zwięzły sposób używania tego konwertera w języku C#.
using CommunityToolkit.Maui.Markup;
class VariableMultiValueConverterPage : ContentPage
{
public VariableMultiValueConverterPage()
{
Content = new Label()
.Text("At least 2 toppings must be selected.")
.Bind(
Label.IsVisibleProperty,
new List<BindingBase>
{
new Binding(static (ViewModel vm) => vm.IsCheeseSelected),
new Binding(static (ViewModel vm) => vm.IsHamSelected),
new Binding(static (ViewModel vm) => vm.IsPineappleSelected)
},
converter: new VariableMultiValueConverter
{
ConditionType = MultiBindingCondition.LessThan,
Count = 2
});
}
}
Właściwości
| Majątek | Typ | Description |
|---|---|---|
| Typ warunku | MultiBindingCondition |
Wskazuje, ile spośród podanych wartości logicznych w obiekcie MultiBinding powinno mieć wartość true. |
| Count | int |
Liczba wartości, które powinny mieć wartość true w przypadku użycia ConditionType z GreaterThan, LessThan lub Exact. |
MultiBindingCondition
Wyliczenie MultiBindingCondition definiuje następujących członków:
-
None— Żadna z wartości nie powinna być prawdziwa. -
All— Wszystkie wartości powinny być prawdziwe. -
Any— Każda z wartości powinna być prawdziwa. -
Exact— Dokładna liczba skonfigurowana weCountwłaściwości powinna mieć wartość true. -
GreaterThan— Większe niż liczba skonfigurowana we właściwościCountpowinno mieć wartość true. -
LessThan— Powinno być prawdą, że wartość jest mniejsza niż liczba skonfigurowana we właściwościCount.
Examples
Przykład działania tego konwertera można znaleźć w przykładowej aplikacji zestawu narzędzi .NET MAUI Community Toolkit.
API
Kod źródłowy VariableMultiValueConverter można znaleźć w repozytorium .NET MAUI Community Toolkit GitHub.
.NET MAUI Community Toolkit