How do we handle validation in WPF ? <\/p>\n
Before we begin…<\/strong><\/p>\n Let’s start by looking at the view model we’re going to work on and write our validation code for – this is a very simple model with a single property “Number” which could ofcourse represent anything you like.<\/p>\n You can assume that OnPropertyChanged fires the INotifyPropertyChanged.PropertyChanged event, but I’ve removed the implementation for brevity.<\/p>\n We’ll be equally simple with our UI, which has the following XAML<\/p>\n Good old IDataErrorInfo<\/strong><\/p>\n So if you’ve used IDataErrorInfo in WinForms, this will be very familiar to you. We can simple implement the IDataErrorInfo interface in our NumberViewModel and add something like the following<\/p>\n To get the WPF binding to actually interact with the IDataErrorInfo we need to change the XAML to look like this<\/p>\n In the above our IDataErrorInfo.this indexer will be called each time the property changes, at which time we can handle the validation either within the view model or ofcourse via some other validation rule class.<\/p>\n ValidationRule validation<\/strong><\/p>\n An alternative to the IDataErrorInfo route for validation are ValidationRules. A ValidateRule implementation of the previous validator is listed below<\/p>\n To use the above rule in XAML we write the following<\/p>\n The ValidationRules (as the pluralism suggests) can have multiple rules listed.<\/p>\n INotifyDataErrorInfo<\/strong><\/p>\n .NET 4.5 included the INotifyDataErrorInfo. This allows us to validate in a more asynchronous way in that we can raise the ErrorsChanged event when we have errors and report them so that the binding engine can then call the GetErrors method to get the list of errors. <\/p>\n BindingGroup<\/strong><\/p>\n The previously highlighted validation methods tend to be aimed more at a specific view model, but what if our view is made up of multiple view models and we want to validate across them all. Then we can look to use the BindingGroup.<\/p>\n The BindingGroup creates a relationship between multiple bindings, which can be validated and updated together<\/a>.<\/p>\n To put it another way, the BindingGroup allows us to validate a group of bindings at the same time. Our sample only has a view model but if we had multiple view models it could validate all the items that make up a BindingGroup. Let’s look at how we could create a BindingGroup.<\/p>\n We give the BindingGroup a name and then we can assign this name to the various bindings – in this example we don’t actually need to use the group name on the textbox as it will be used within the validation, but hopefully you can see how the syntax would look.<\/p>\n Now let’s take a look at the ValidDataValidationRule code<\/p>\n The Items collection will contain the various groups that have been assigned the BindingGroup name and then we can validate across all the data contexts.<\/p>\n Unfortunately, this doesn’t just happen magically. Instead, we need to invoke it. If we give the name DataElement<\/em> to the StackPanel and for the sake of simplicity we add a button with a Click handler, we can then call the BindingGroup’s CommitEdit method to force validation, i.e.<\/p>\n Note: The default style is to draw a read line around the control which fails validation, if you’ve placed the StackPanel as the top level Window you might need to add a margin to see the red border.<\/em><\/p>\n ValidationStep<\/strong><\/p>\n On both the BindingGroup and ValidationRule we can set the ValidationStep property. This allows us to tell the binding mechanism at what stage it should invoke the validation rule.<\/p>\n This can be set to one of four values<\/p>\n CommittedValue:<\/em> Runs the ValidationRule after the value has been committed to the source. Note: The above definitions were taken from ValidationStep Enumeration<\/a><\/em><\/p>\n Data annotations<\/strong><\/p>\n Finally, let’s take a look at data annotations or more specifically validation attributes that are part of the System.ComplonentMode.DataAnnotations<\/em> namespace.<\/p>\n With the data annotations we can apply attributes to a class or its members which denote the validation rules to be used. For example<\/p>\n In this example we’ve removed the get\/set actual implementation, for brevity.<\/em><\/p>\n Now this code requires use to write code to validation the property, for example in our setter we might have code like this<\/p>\n Enhancing the user interface<\/strong><\/p>\n So far, I’ve not done anything to make the user experience any better regarding validation, i.e. you will only see a red border around our text box, but this doesn’t really help the user identify what’s gone wrong, so now let’s look at how we might change our UI to better reflect the validation failures.<\/p>\n Ofcourse, we’ve been busy creating error messages, but so far not shown them in the UI, so we could use something like the following<\/p>\n This will display the first error message just beneath the TextBox. <\/p>\n Another alternative is to style the text box with a trigger against the Validation.HasError property<\/p>\n References<\/strong><\/p>\n Data validation in WPF<\/a> How do we handle validation in WPF ? Before we begin… Let’s start by looking at the view model we’re going to work on and write our validation code for – this is a very simple model with a single property “Number” which could ofcourse represent anything you like. public class NumberViewModel : INotifyPropertyChanged { […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[13],"tags":[],"class_list":["post-2867","post","type-post","status-publish","format-standard","hentry","category-wpf"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/2867","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/comments?post=2867"}],"version-history":[{"count":5,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/2867\/revisions"}],"predecessor-version":[{"id":9558,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/2867\/revisions\/9558"}],"wp:attachment":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/media?parent=2867"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/categories?post=2867"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/tags?post=2867"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\r\npublic class NumberViewModel : INotifyPropertyChanged\r\n{\r\n \/\/ standard implementation of INotifyPropertyChanged removed \r\n private int number;\r\n\r\n public int Number\r\n {\r\n get { return number; }\r\n set\r\n {\r\n if (number != value)\r\n {\r\n number = value;\r\n OnPropertyChanged("Number");\r\n }\r\n }\r\n }\r\n}\r\n<\/pre>\n\r\n<TextBox Text="{Binding Number}" \/>\r\n<\/pre>\n\r\nstring IDataErrorInfo.Error\r\n{\r\n get { return null; }\r\n}\r\n\r\nstring IDataErrorInfo.this[string columnName]\r\n{\r\n get\r\n {\r\n if (columnName == "Number")\r\n {\r\n if (number < 0)\r\n return "Number must be greater or equal to 0";\r\n }\r\n return null;\r\n }\r\n}\r\n<\/pre>\n\r\n<TextBox Text="{Binding Number, UpdateSourceTrigger=PropertyChanged, ValidatesOnDataErrors=True}" \/>\r\n<\/pre>\n\r\npublic class PostiveValidationRule : ValidationRule\r\n{\r\n public override ValidationResult Validate(object value, CultureInfo cultureInfo)\r\n {\r\n int result;\r\n if (value != null && Int32.TryParse(value.ToString(), out result))\r\n {\r\n if (result < 0)\r\n return new ValidationResult(\r\n false, "Number must be greater or equal to 0");\r\n }\r\n return ValidationResult.ValidResult;\r\n }\r\n}\r\n<\/pre>\n\r\n<TextBox>\r\n <TextBox.Text>\r\n <Binding Path="Number" \r\n ValidatesOnDataErrors="True" \r\n UpdateSourceTrigger="PropertyChanged">\r\n <Binding.ValidationRules>\r\n <validators:PostiveValidationRule \/>\r\n <\/Binding.ValidationRules>\r\n <\/Binding>\r\n <\/TextBox.Text>\r\n<\/TextBox>\r\n<\/pre>\n
\r\n<StackPanel>\r\n <StackPanel.BindingGroup>\r\n <BindingGroup Name="ValidDataGroup">\r\n <BindingGroup.ValidationRules>\r\n <validators:ValidDataValidationRule \/>\r\n <\/BindingGroup.ValidationRules>\r\n <\/BindingGroup>\r\n <\/StackPanel.BindingGroup>\r\n <TextBox Text="{Binding Text, ValidatesOnDataErrors=True, BindingGroupName=ValidDataGroup}" \/>\r\n<\/pre>\n\r\npublic class ValidDataValidationRule : ValidationRule\r\n{\r\n public override ValidationResult Validate(object value, CultureInfo cultureInfo)\r\n {\r\n var bindingGroup = (BindingGroup)value;\r\n if (bindingGroup != null)\r\n {\r\n var numberViewModel = bindingGroup.Items[0] as NumberViewModel;\r\n if (numberViewModel != null)\r\n {\r\n if (numberViewModel.Number < 0)\r\n {\r\n return new ValidationResult(\r\n false, \r\n "Number must be greater or equal to 0");\r\n }\r\n } \r\n }\r\n return ValidationResult.ValidResult;\r\n }\t\t\r\n}\r\n<\/pre>\n\r\nDataElement.BindingGroup.CommitEdit();\r\n<\/pre>\n
\nConvertedProposedValue:<\/em> Runs the Validation rule after a value is converetd.
\nRawProposedValue:<\/em> Runs the validation before any conversion occurs.
\nUpdatedValue:<\/em> Runs the ValidationRule after the source is updated.<\/p>\n\r\npublic class ValidationModel\r\n{\r\n [Required(ErrorMessage = "First name is a required field")]\r\n public string FirstName { get; set; }\r\n}\r\n<\/pre>\n\r\nvar validationContext = new ValidationContext(this, null, null);\r\nvalidationContext.MemberName = nameof(FirstName);\r\nValidator.ValidateProperty(value, validationContext);\r\n<\/pre>\n
\r\n<TextBox Text="{Binding Number, \r\n UpdateSourceTrigger=PropertyChanged, \r\n ValidatesOnDataErrors=True}">\r\n <Validation.ErrorTemplate>\r\n <ControlTemplate>\r\n <StackPanel>\r\n <AdornedElementPlaceholder \/>\r\n <TextBlock Text="{Binding [0].ErrorContent}" Foreground="Red"\/>\r\n <\/StackPanel>\r\n <\/ControlTemplate>\r\n <\/Validation.ErrorTemplate>\r\n<\/TextBox>\r\n<\/pre>\n\r\n<Style TargetType="{x:Type TextBox}">\r\n <Style.Triggers>\r\n <Trigger Property="Validation.HasError" Value="True">\r\n <Setter Property="Background" Value="Red" \/>\r\n <Setter Property="ToolTip"\r\n Value="{Binding RelativeSource={x:Static RelativeSource.Self},\r\n Path=(Validation.Errors)[0].ErrorContent}"\/>\r\n <\/Trigger>\r\n <\/Style.Triggers>\r\n<\/Style>\r\n<\/pre>\n
\nUsing BindingGroups For Greater Control Over Input Validation<\/a>
\nBindingGroups For Total View Validation<\/a>
\nWPF 3.5 SP1 Feature: BindingGroups with Item-level Validation<\/a>
\nValidation in Windows Presentation Foundation<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"