RequiredStringValidationBehavior

아티클
04/02/2024

사용자가 RequiredStringValidationBehaviorBehavior 텍스트 입력이 특정 텍스트와 같은지 확인할 수 있도록 하는 것입니다. 예를 들어 Entry 유효한 텍스트 입력 또는 잘못된 텍스트 입력이 제공되었는지 여부에 따라 컨트롤의 스타일이 다르게 지정될 수 있습니다.

Important

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

구문

다음 예제에서는 입력되었는지 여부에 RequiredString 따라 해당 항목을 추가하고 RequiredStringValidationBehaviorEntry 변경하는 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>

RequiredStringValidationBehavior 사용

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

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

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

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

C# 태그

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

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"
            });
    }
}

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

속성

속성	Type	설명
`ExactMatch`	`bool`	입력한 텍스트가 속성의 `RequiredString` 전체 내용과 일치해야 하는지 아니면 속성 값을 포함 `RequiredString` 해야 하는지 여부를 결정합니다.
`RequiredString`	`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 리포지토리에서 오버에 대한 RequiredStringValidationBehavior 소스 코드를 찾을 수 있습니다.

다음을 통해 공유