CharactersValidationBehavior

아티클
04/02/2024

사용자가 CharactersValidationBehaviorBehavior 지정된 매개 변수에 따라 텍스트 입력의 유효성을 검사할 수 있도록 하는 것입니다. 예를 들어 Entry 유효한 텍스트 값 또는 잘못된 텍스트 값이 제공되었는지 여부에 따라 컨트롤의 스타일이 다르게 지정될 수 있습니다. 이 동작에는 특정 수의 숫자 또는 영숫자 문자에 대한 검사 같은 기본 제공 검사 포함됩니다.

Important

동작을 공유하고 스타일을 통해 여러 컨트롤에 적용할 수 있으므로 .NET MAUI 커뮤니티 도구 키트 동작은 동작을 설정 BindingContext 하지 않습니다. 자세한 내용은 .NET MAUI 동작을 참조 하세요.

구문

다음 예제에서는 입력한 Entry 텍스트에 숫자만 포함되고 숫자가 2개 이상 있는지 여부에 따라 값을 추가하고 CharactersValidationBehavior 변경하는 TextColor 방법을 보여 줍니다.

XAML

XAML 네임스페이스 포함

XAML에서 도구 키트를 사용하려면 페이지 또는 보기에 다음 xmlns 을 추가해야 합니다.

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

따라서 다음을 수행합니다.

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

다음과 같이 포함 xmlns 하도록 수정됩니다.

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

CharactersValidationBehavior 사용

XAML CharactersValidationBehavior 에서 다음과 같이 사용할 수 있습니다.

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

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

</ContentPage>

C#

CharactersValidationBehavior C#에서 다음과 같이 사용할 수 있습니다.

class CharactersValidationBehaviorPage : ContentPage
{
    public CharactersValidationBehaviorPage()
    {
        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 charactersValidationBehavior = new CharactersValidationBehavior
        {
            InvalidStyle = invalidStyle,
            ValidStyle = validStyle,
            Flags = ValidationFlags.ValidateOnValueChanged,
            CharacterType = CharacterType.Digit,
            MinimumCharacterTypeCount = 3
        };

        entry.Behaviors.Add(charactersValidationBehavior);

        Content = entry;
    }
}

C# 태그

이 CommunityToolkit.Maui.Markup 패키지는 C#에서 이를 Behavior 사용하는 훨씬 더 간결한 방법을 제공합니다.

using CommunityToolkit.Maui.Markup;

class CharactersValidationBehaviorPage : ContentPage
{
    public CharactersValidationBehaviorPage()
    {
        Content = new Entry()
            .Behaviors(new CharactersValidationBehavior
            {
                InvalidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Red),
                ValidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Green),
                Flags = ValidationFlags.ValidateOnValueChanged,
                CharacterType = CharacterType.Digit,
                MinimumCharacterTypeCount = 3
            });
    }
}

다음 스크린샷은 Android의 결과 CharactersValidationBehavior를 보여줍니다. Android의 CharactersValidationBehavior 스크린샷

속성

속성	Type	설명
`CharacterType`	`CharacterType`	비교를 처리하는 방법을 설정하는 데 사용할 열거형 값을 제공합니다.
`DecorationFlags`	`TextDecorationFlags`	공백을 처리하는 방법을 설정하는 데 사용할 열거형 값을 제공합니다.
`MaximumCharacterTypeCount`	`int`	필요한 최대 문자 수 `CharacterType` 입니다.
`MaximumLength`	`int`	허용되는 값의 최대 길이입니다.
`MinimumCharacterTypeCount`	`int`	필요한 최소 문자 수 `CharacterType` 입니다.
`MinimumLength`	`int`	허용되는 값의 최소 길이입니다.
`RegexOptions`	`RegexOptions`	정규식 옵션을 설정하는 데 사용할 열거형 값을 제공합니다.
`RegexPattern`	`string`	값이 허용되기 전에 일치해야 하는 정규식 패턴입니다.

ValidationBehavior 속성

다음 속성은 기본 클래스 public abstract class ValidationBehavior에서 구현됩니다.

속성	Type	설명
`Flags`	`ValidationFlags`	유효성 검사를 처리하는 방법을 지정하는 열거형 값을 제공합니다.
`ForceValidateCommand`	`ICommand`	사용자가 강제 유효성 검사를 처리하는 사용자 지정 `ICommand` 을 제공할 수 있습니다.
`InvalidStyle`	`Style`	`Style` 유효성 검사에 실패할 때 요소에 적용할 값입니다.
`IsNotValid`	`bool`	현재 값이 잘못된 것으로 간주되는지 여부를 나타냅니다.
`IsRunning`	`bool`	유효성 검사가 현재 진행 중인지 여부를 나타냅니다(비동기 호출 대기가 완료됨).
`IsValid`	`bool`	현재 값이 유효한 것으로 간주되는지 여부를 나타냅니다.
`ValidStyle`	`Style`	`Style` 유효성 검사에 성공하면 요소에 적용할 값입니다.
`Value`	`object`	유효성을 검사할 값입니다.
`ValuePropertyName`	`string`	사용자가 유효성을 검사할 값으로 사용할 속성을 재정의할 수 있습니다.

예제

.NET MAUI 커뮤니티 도구 키트 샘플 애플리케이션에서 이 동작의 예를 찾을 수 있습니다.

API

.NET MAUI 커뮤니티 도구 키트 GitHub 리포지토리에서 오버에 대한 CharactersValidationBehavior 소스 코드를 찾을 수 있습니다.

다음을 통해 공유