淺談WPF之Binding時數據校驗和類型轉換

在WPF開發中，Binding實現了數據在Source和Target之間的傳遞和流通，就像現實生活中的一條條道路，建立起了城鎮與城鎮之間的銜接，而數據校驗和類型轉換，就像高速公路之間的收費站和安檢站。那在WPF開發中，如何實現數據的校驗和類型轉換呢？本文以一個簡單的小例子，簡述在WPF開發中，實現數據校驗和類型轉換的相關知識點，僅供學習分享使用，如有不足之處，還請指正。

在數據綁定Binding中，數據校驗主要通過ValidationRules屬性，數據轉換主要通過Converter屬性。

 

數據校驗

 

在WPF開發中，校驗數據的有效性，主要步驟如下：

 

1. 實現校驗規則

 

Binding的ValidationRules是Collection<ValidationRule>類型，是一個校驗規則列表，可以支持多重校驗。而ValidationRule是一個抽象類，所有要實現業務規則校驗，就要繼承ValidationRule並實現抽象方法。

ValidationRule的Validate方法返回一個ValidationResult對象，如果校驗通過，則ValidationResult的IsValid爲true，否則爲false。RangeValidationRule主要校驗用戶輸入數據的範圍：

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Controls;

namespace WpfApp4.DataValidate
{
    public class RangeValidationRule : ValidationRule
    {
        public override ValidationResult Validate(object value, CultureInfo cultureInfo)
        {
            double d = 0;
            if(double.TryParse(value.ToString(),out d))
            {
                if(d>=0 && d <= 100)
                {
                    return new ValidationResult(true,null);
                }
            }
            return new ValidationResult(false, "數據必須在0~100之間");
        }
    }
}

 

2. 設置規則

 

要想應用規則，首先需要引入規則對應的命名空間：xmlns:v="clr-namespace:WpfApp4.DataValidate"

然後設置Binding的ValidationRules規則，如下所示：

<TextBlock Text="年齡" VerticalAlignment="Center"></TextBlock>
<TextBox x:Name="tbAge" Width="120" Height="25" Margin="10" Validation.Error="tbAge_Error" VerticalContentAlignment="Center">
	<TextBox.Text>
		<Binding Path="Age" UpdateSourceTrigger="PropertyChanged" NotifyOnValidationError="True">
			<Binding.ValidationRules>
				<v:RangeValidationRule ValidatesOnTargetUpdated="True"></v:RangeValidationRule>
			</Binding.ValidationRules>
		</Binding>
	</TextBox.Text>
</TextBox>
<TextBlock VerticalAlignment="Center" Text="{Binding DataError}" Foreground="Red"></TextBlock>

關於校驗規則，有以下幾點需要注意：

默認情況下，認爲Source的數據總是正確的，規則校驗只有當Target更新時，纔會生效，因爲Target多爲用戶輸入；如果當Source更新時也要生效，則需要配置ValidatesOnTargetUpdated爲true。

默認情況下，校驗規則返回的錯誤信息，是不會輸出到UI的，如果要輸出要UI，需要設置NotifyOnValidationError屬性爲true。

 

3. 輸出校驗信息

 

默認情況下，校驗信息不會輸出到UI，只是顯示用戶控件爲紅色邊框，如果要輸出校驗信息，除了設置NotifyOnValidationError屬性外，還要訂閱Validation.Error事件，並在事件中處理要顯示的錯誤信息，如下所示：

private void tbAge_Error(object sender, ValidationErrorEventArgs e)
{
	this.viewModel.ValidationErrorCommand.Execute(e);
}

其中上述方法中的命令爲ViewModel中定義，如下所示：

public class MainWindowViewModel : ObservableObject
{
	private int age;

	public int Age
	{
		get { return age; }
		set { SetProperty(ref age , value); }
	}

	private string dataError;

	public string DataError
	{
		get { return dataError; }
		set { SetProperty(ref dataError , value); }
	}


	private TextBox textBox;

	private ICommand winLoadedCommand;

	public ICommand WinLoadedCommand
	{
		get {
			if (winLoadedCommand == null)
			{
				winLoadedCommand = new RelayCommand<object>(WinLoaded);
			}
			return winLoadedCommand; }
	}

	private void WinLoaded(object sender)
	{
		if (sender != null)
		{
			var win = sender as MainWindow;
			this.textBox = win.tbAge;
		}
	}



	private ICommand validationErrorCommand;

	public ICommand ValidationErrorCommand
	{
		get {
			if (validationErrorCommand == null)
			{
				validationErrorCommand = new RelayCommand<object>(DisplayValidationError);
			}
			return validationErrorCommand; }
	}

	private void DisplayValidationError(object obj)
	{
		if (Validation.GetErrors(this.textBox).Count > 0)
		{
			this.DataError= Validation.GetErrors(this.textBox)[0].ErrorContent.ToString();
		}
		else
		{
			this.DataError = string.Empty;
		}
	}

}

 

4. 數據校驗示例演示

 

經過上述步驟，運行程序，如下所示：

 

數據類型轉換

 

在數據綁定時，如果Source端的數據類型和Target端的數據類型不一致時，就需要用到數據類型轉換，如：true/false與顯示/隱藏之間的轉換等，要實現數據轉換，需要用到Binding的Converter屬性。步驟如下：

 

1. 定義轉換器

 

Binding的Converter屬性是IValueConverter類型，所以定義轉換器需要實現IValueConverter接口，如下所示：

namespace WpfApp4.DataConverter
{
    public class BoolToVisilityConverter : IValueConverter
    {
        /// <summary>
        /// Source 到 Target
        /// </summary>
        /// <param name="value"></param>
        /// <param name="targetType"></param>
        /// <param name="parameter"></param>
        /// <param name="culture"></param>
        /// <returns></returns>
        public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        {
            var flag = bool.Parse(value.ToString());
            if(flag)
            {
                return Visibility.Visible;
            }
            else
            {
                return Visibility.Collapsed;
            }
        }

        /// <summary>
        /// Target到Source
        /// </summary>
        /// <param name="value"></param>
        /// <param name="targetType"></param>
        /// <param name="parameter"></param>
        /// <param name="culture"></param>
        /// <returns></returns>
        public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        {
            var visibility = Visibility.Collapsed;
            if (Enum.TryParse<Visibility>(value.ToString(), out visibility))
            {
                if (visibility == Visibility.Collapsed)
                {
                    return false;
                }
                else if(visibility == Visibility.Visible)
                {
                    return true;
                }
                else
                {
                    return false;
                }
            }

            return false;
        }
    }
}

注意：IValueConverter接口共兩個方法，其中Convert方法當Source到Target時調用，ConvertBack方法則是反方向調用。

 

2. 定義資源

 

轉換器也是一種資源，要聲明資源，首先引入命名空間xmlns:c="clr-namespace:WpfApp4.DataConverter"，如下所示：

<Window.Resources>
	<c:BoolToVisilityConverter x:Key="boolToVisility"></c:BoolToVisilityConverter>
</Window.Resources>

 

3. 調用類型轉換

 

在Binding時，調用資源Visibility="{Binding ElementName=chk01, Path=IsChecked, Converter={StaticResource boolToVisility}}"。通過複選框的選擇與否，控制控件的顯示與隱藏，如下所示：

<StackPanel Orientation="Horizontal" Grid.Row="0">
	<CheckBox Content="顯示" x:Name="chk01"></CheckBox>
</StackPanel>
<StackPanel Orientation="Horizontal" Grid.Row="1" Visibility="{Binding ElementName=chk01, Path=IsChecked, Converter={StaticResource boolToVisility}}">
	<TextBlock Text="年齡" VerticalAlignment="Center"></TextBlock>
	<TextBox x:Name="tbAge" Width="120" Height="25" Margin="10" Validation.Error="tbAge_Error" VerticalContentAlignment="Center">
		<TextBox.Text>
			<Binding Path="Age" UpdateSourceTrigger="PropertyChanged" NotifyOnValidationError="True">
				<Binding.ValidationRules>
					<v:RangeValidationRule ValidatesOnTargetUpdated="True"></v:RangeValidationRule>
				</Binding.ValidationRules>
			</Binding>
		</TextBox.Text>
	</TextBox>
	<TextBlock VerticalAlignment="Center" Text="{Binding DataError}" Foreground="Red"></TextBlock>
</StackPanel>

 

4. 數據類型轉換示例演示

 

 

源碼下載

 

本實例源碼相對簡單，如果需要源碼下載，可關注公衆號，回覆關鍵字DATAVC進行獲取，如下所示：

以上就是【淺談WPF之Binding時數據校驗和類型轉換】的全部內容，關於更多詳細內容，可參考官方文檔。希望能夠一起學習，共同進步。