NumericValidationBehavior

Článek
04/02/2024

Jedná se NumericValidationBehavior o hodnotu Behavior , která uživateli umožňuje určit, jestli je textové zadání platnou číselnou hodnotou. Ovládací prvek může být například stylován odlišně v závislosti na tom, Entry jestli je zadaný platný nebo neplatný číselný vstup.

Důležité

Chování sady nástrojů .NET MAUI Community Toolkit nenastavuje BindingContext chování, protože chování lze sdílet a použít u více ovládacích prvků prostřednictvím stylů. Další informace najdete v tématu Chování rozhraní .NET MAUI.

Syntaxe

Následující příklady ukazují, jak přidat NumericValidationBehavior k Entry a změnit TextColor , kdy zadané číslo je považováno za neplatné (ne mezi 1 a 100).

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í NumericValidationBehavior

V XAML je možné ho NumericValidationBehavior 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.Behaviors.NumericValidationBehaviorPage">

    <ContentPage.Resources>
        <Style x:Key="InvalidEntryStyle" TargetType="Entry">
            <Setter Property="TextColor" Value="Red" />
        </Style>
        <Style x:Key="ValidEntryStyle" TargetType="Entry">
            <Setter Property="TextColor" Value="Green" />
        </Style>
    </ContentPage.Resources>

    <Entry Keyboard="Numeric">
        <Entry.Behaviors>
            <toolkit:NumericValidationBehavior 
                InvalidStyle="{StaticResource InvalidEntryStyle}"
                ValidStyle="{StaticResource ValidEntryStyle}"
                Flags="ValidateOnValueChanged"
                MinimumValue="1.0"
                MaximumValue="100.0"
                MaximumDecimalPlaces="2" />
        </Entry.Behaviors>
    </Entry>

</ContentPage>

C#

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

class NumericValidationBehaviorPage : ContentPage
{
    public NumericValidationBehaviorPage()
    {
        var entry = new Entry
        {
            Keyboard = Keyboard.Numeric
        };

        var validStyle = new Style(typeof(Entry));
        validStyle.Setters.Add(new Setter
        {
            Property = Entry.TextColorProperty,
            Value = Colors.Green
        });

        var invalidStyle = new Style(typeof(Entry));
        invalidStyle.Setters.Add(new Setter
        {
            Property = Entry.TextColorProperty,
            Value = Colors.Red
        });

        var numericValidationBehavior = new NumericValidationBehavior
        {
            InvalidStyle = invalidStyle,
            ValidStyle = validStyle,
            Flags = ValidationFlags.ValidateOnValueChanged,
            MinimumValue = 1.0,
            MaximumValue = 100.0,
            MaximumDecimalPlaces = 2
        };

        entry.Behaviors.Add(numericValidationBehavior);

        Content = entry;
    }
}

Revize jazyka C#

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

using CommunityToolkit.Maui.Markup;

class NumericValidationBehaviorPage : ContentPage
{
    public NumericValidationBehaviorPage()
    {
        Content = new Entry
        {
            Keyboard = Keyboard.Numeric
        }.Behaviors(new NumericValidationBehavior
        {
            InvalidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Red),
            ValidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Green),
            Flags = ValidationFlags.ValidateOnValueChanged,
            MinimumValue = 1.0,
            MaximumValue = 100.0,
            MaximumDecimalPlaces = 2
        });
    }
}

Vlastnosti

Vlastnost	Type	Popis
`MaximumDecimalPlaces`	`double`	Maximální počet desetinných míst, která budou povolena.
`MinimumDecimalPlaces`	`double`	Minimální počet desetinných míst, která budou povolena.
`MaximumValue`	`double`	Maximální číselná hodnota, která bude povolena.
`MinimumValue`	`double`	Minimální číselná hodnota, která bude povolena.

Vlastnosti ValidationBehavior

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

Vlastnost	Type	Popis
`Flags`	`ValidationFlags`	Poskytuje výčtovou hodnotu, která určuje, jak zpracovat ověření.
`ForceValidateCommand`	`ICommand`	Umožňuje uživateli zadat vlastní `ICommand` popisovač ověřování.
`InvalidStyle`	`Style`	Hodnota `Style` , která se má použít u elementu při selhání ověření.
`IsNotValid`	`bool`	Určuje, zda je aktuální hodnota považována za neplatnou.
`IsRunning`	`bool`	Označuje, jestli právě probíhá ověření (čeká se na dokončení asynchronního volání).
`IsValid`	`bool`	Určuje, zda je aktuální hodnota považována za platnou.
`ValidStyle`	`Style`	To `Style` platí pro prvek, pokud je ověření úspěšné.
`Value`	`object`	Hodnota, která má být ověřena
`ValuePropertyName`	`string`	Umožňuje uživateli přepsat vlastnost, která se použije jako hodnota k ověření.

Příklady

Příklad tohoto chování v akci najdete v ukázkové aplikaci .NET MAUI Community Toolkit.

rozhraní API

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

Sdílet prostřednictvím