RequiredStringValidationBehavior

Jedná se RequiredStringValidationBehavior o typ Behavior , který uživateli umožňuje určit, jestli se textové zadání rovná určitému textu. 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ý textový 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 RequiredStringValidationBehavior do a Entry změnit TextColor na základě toho, zda RequiredString byl zadán.

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

V XAML je možné ho RequiredStringValidationBehavior 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.RequiredStringValidationBehaviorPage">

    <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>
        <Entry.Behaviors>
            <toolkit:RequiredStringValidationBehavior 
                InvalidStyle="{StaticResource InvalidEntryStyle}"
                ValidStyle="{StaticResource ValidEntryStyle}"
                Flags="ValidateOnValueChanged"
                RequiredString="MAGIC ANSWER" />
        </Entry.Behaviors>
    </Entry>

</ContentPage>

C#

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

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

        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 requiredStringValidationBehavior = new RequiredStringValidationBehavior
        {
            InvalidStyle = invalidStyle,
            ValidStyle = validStyle,
            Flags = ValidationFlags.ValidateOnValueChanged,
            RequiredString = "MAGIC ANSWER"
        };

        entry.Behaviors.Add(requiredStringValidationBehavior);

        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 RequiredStringValidationBehaviorPage : ContentPage
{
    public RequiredStringValidationBehaviorPage()
    {
        Content = new Entry()
            .Behaviors(new RequiredStringValidationBehavior
            {
                InvalidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Red),
                ValidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Green),
                Flags = ValidationFlags.ValidateOnValueChanged,
                RequiredString = "MAGIC ANSWER"
            });
    }
}

Následující snímek obrazovky ukazuje výsledný RequiredStringValidationBehavior v Androidu:

Vlastnosti

Vlastnost	Type	Popis
ExactMatch	bool	Určuje, zda zadaný text musí odpovídat celému RequiredString obsahu vlastnosti nebo jednoduše obsahovat RequiredString hodnotu vlastnosti.
RequiredString	string	Řetězec, který bude porovnán s hodnotou poskytnutou uživatelem.

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 RequiredStringValidationBehavior najdete v úložišti .NET MAUI Community Toolkit na GitHubu.