EmailValidationBehavior

Das EmailValidationBehavior ist ein Behavior, mit dem Benutzer feststellen können, ob eine Texteingabe eine gültige E-Mail-Adresse ist. Beispielsweise kann ein Entry Steuerelement unterschiedlich formatiert werden, je nachdem, ob eine gültige oder eine ungültige E-Mail-Adresse angegeben wird. Die Überprüfung erfolgt über einen regulären Ausdruck, der verwendet wird, um zu überprüfen, ob es sich bei der Texteingabe um eine gültige E-Mail-Adresse handelt.

Wenn es an ein InputView (z. B. Entry, Editor usw.) angefügt wird, ändert EmailValidationBehavior die Standardtastatur, Keyboard.Default, zu Keyboard.Email. Wenn für InputView ein von der Standardeinstellung abweichender Keyboard angegeben wurde, ändert EmailValidationBehavior den Keyboard nicht.

Wenn die Verbindung zu einem InputView getrennt wird, ändert EmailValidationBehaviorKeyboard.Email wieder in Keyboard.Default. Wenn für den InputView ein anderer Keyboard als Keyboard.Email angegeben wurde, ändert EmailValidationBehavior den Keyboard beim Trennen nicht.

Syntax

Die folgenden Beispiele zeigen, wie Sie das EmailValidationBehavior zu einem Entry hinzufügen und das TextColor abhängig davon ändern, ob der eingegebene Text eine gültige E-Mail-Adresse ist.

XAML

Einbinden des XAML-Namespace

Um das Toolkit in XAML verwenden zu können, muss der folgende xmlns-Abschnitt zu Ihrer Seite oder Ansicht hinzugefügt werden:

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

Daher das Folgende:

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

Würde geändert werden, um das xmlns wie folgt einzubinden:

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

Verwenden von EmailValidationBehavior

Die EmailValidationBehavior kann wie folgt in XAML verwendet werden:

<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.EmailValidationBehaviorPage">

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

</ContentPage>

C#

Die EmailValidationBehavior kann wie folgt in C# verwendet werden:

class EmailValidationBehaviorPage : ContentPage
{
    public EmailValidationBehaviorPage()
    {
        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 emailValidationBehavior = new EmailValidationBehavior
        {
            InvalidStyle = invalidStyle,
            ValidStyle = validStyle,
            Flags = ValidationFlags.ValidateOnValueChanged
        };

        entry.Behaviors.Add(emailValidationBehavior);

        Content = entry;
    }
}

C#-Markup

Unser CommunityToolkit.Maui.Markup Paket bietet eine viel präzisere Möglichkeit, dies Behavior in C# zu verwenden.

using CommunityToolkit.Maui.Markup;

class EmailValidationBehaviorPage : ContentPage
{
    public EmailValidationBehaviorPage()
    {
        Content = new Entry()
            .Behaviors(new EmailValidationBehavior
            {
                InvalidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Red),
                ValidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Green),
                Flags = ValidationFlags.ValidateOnValueChanged
            });
    }
}

Der folgende Screenshot zeigt das resultierende EmailValidationBehavior unter Android:

Eigenschaften

ValidationBehavior-Eigenschaften

Die folgenden Eigenschaften werden in der Basisklasse public abstract class ValidationBehaviorimplementiert:

Methodik

Beispiele

Sie finden ein Beispiel für dieses Verhalten in Aktion in der .NET MAUI Community Toolkit-Beispielanwendung.

API

Sie finden den Quellcode für EmailValidationBehavior im .NET MAUI Community Toolkit GitHub Repository.