Table of Contents

Uranium UI Data Annotations

Uranium UI provides a wrapper for the DataAnnotations validation. It's a simple wrapper that allows you to use the DataAnnotations validation with the FormView. It allows you to define the validation rules in the view model class with System.ComponentModel.DataAnnotations attributes.

Getting Started

DataAnnotations attributes aren't provided by default. To use the DataAnnotations validation, you need to install the UraniumUI.Validations.DataAnnotations NuGet package.

dotnet add package UraniumUI.Validations.DataAnnotations

Usage

DataAnnotationsBehavior is a behavior that allows you to bind the validations from the ViewModel to the control. It's used with the FormView to validate the controls.

  • Add xmlns for the UraniumUI.Validations namespace.

    xmlns:v="clr-namespace:UraniumUI.Validations;assembly=UraniumUI.Validations.DataAnnotations"
    
  • Use the DataAnnotationsBehavior method to bind the control with the validation rules.

    <input:FormView>
        <material:TextField Text="{Binding Email}">
            <material:TextField.Behaviors>
                <v:DataAnnotationsBehavior Binding="{Binding Email}" />
            </material:TextField.Behaviors>
        </material:TextField>
            <!-- ... -->
    </input:FormView>
    
    Tip

    If you're not familiar with the FormView, you can check the FormView documentation first to get more information about it.

    Warning

    If you're using v:ValidationBinding in your project, you need to migrate to this new behavior.

    See the Migration Guide for more information.

  • Add the System.ComponentModel.DataAnnotations attributes to the view model class.

    [Required]
    [EmailAddress]
    [MinLength(5)]
    public string Email { get; set; }
    

    You can check the DataAnnotations documentation to learn more about the attributes.

    uraniumui data annotations