NumericValidationBehavior

아티클
04/02/2024

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

Important

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

구문

다음 예제에서는 입력한 숫자가 잘못된 것으로 간주되는 경우(1에서 100 사이가 아님)를 추가하고 NumericValidationBehaviorEntry 변경하는 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>

NumericValidationBehavior 사용

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

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

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

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

C# 태그

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

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

속성

속성	Type	설명
`MaximumDecimalPlaces`	`double`	허용되는 최대 소수 자릿수입니다.
`MinimumDecimalPlaces`	`double`	허용되는 최소 소수 자릿수입니다.
`MaximumValue`	`double`	허용되는 최대 숫자 값입니다.
`MinimumValue`	`double`	허용되는 최소 숫자 값입니다.

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 리포지토리에서 오버에 대한 NumericValidationBehavior 소스 코드를 찾을 수 있습니다.

Share via