HOW TO：實作繫結驗證

發行項
08/12/2011

本範例顯示如何使用 ErrorTemplate 和樣式觸發程序，以提供視覺化回應，依據自訂驗證規則以在輸入無效值時通知使用者。

範例

下列範例中 TextBox 的文字內容，是繫結到名為 ods 的繫結來源物件的 Age 屬性 (型別 int)。繫結是設為使用名為 AgeRangeRule 的驗證規則，因此如果使用者輸入非數值字元或小於 21 或大於 130 的值，文字方塊旁邊會出現紅色驚嘆號，並在使用者移動滑鼠到文字方塊上方時出現具有錯誤訊息的工具提示。

<TextBox Name="textBox1" Width="50" FontSize="15"
         Validation.ErrorTemplate="{StaticResource validationTemplate}"
         Style="{StaticResource textBoxInError}"
         Grid.Row="1" Grid.Column="1" Margin="2">
  <TextBox.Text>
    <Binding Path="Age" Source="{StaticResource ods}"
             UpdateSourceTrigger="PropertyChanged" >
      <Binding.ValidationRules>
        <c:AgeRangeRule Min="21" Max="130"/>
      </Binding.ValidationRules>
    </Binding>
  </TextBox.Text>
</TextBox>

下列範例顯示 AgeRangeRule 的實作，該規則繼承自 ValidationRule 並會覆寫 Validate 方法。 Int32.Parse() 方法會針對值呼叫，以確認當中沒有包含任何無效的字元。 Validate 方法傳回的 ValidationResult 會依據剖析期間是否有攔截到例外狀況以及年齡值是否超出上下限，以指出值是否有效。

public class AgeRangeRule : ValidationRule
{
    private int _min;
    private int _max;

    public AgeRangeRule()
    {
    }

    public int Min
    {
        get { return _min; }
        set { _min = value; }
    }

    public int Max
    {
        get { return _max; }
        set { _max = value; }
    }

    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        int age = 0;

        try
        {
            if (((string)value).Length > 0)
                age = Int32.Parse((String)value);
        }
        catch (Exception e)
        {
            return new ValidationResult(false, "Illegal characters or " + e.Message);
        }

        if ((age < Min) || (age > Max))
        {
            return new ValidationResult(false,
              "Please enter an age in the range: " + Min + " - " + Max + ".");
        }
        else
        {
            return new ValidationResult(true, null);
        }
    }
}

下列範例顯示的自訂 ControlTemplate validationTemplate 會建立紅色驚嘆號，告知使用者發生驗證錯誤。控制項樣板是用於重新定義控制項的外觀。

<ControlTemplate x:Key="validationTemplate">
  <DockPanel>
    <TextBlock Foreground="Red" FontSize="20">!</TextBlock>
    <AdornedElementPlaceholder/>
  </DockPanel>
</ControlTemplate>

如下列範例所示，顯示錯誤訊息的 ToolTip 是使用名為 textBoxInError 的樣式建立的。如果 HasError 的值為 true，觸發程序會將目前 TextBox 的工具提示設定為其第一個驗證錯誤。 RelativeSource 設定為 Self，代表目前的項目。

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

如需完整範例，請參閱繫結驗證範例 (英文)。

請注意，如果您沒有提供自訂 ErrorTemplate，就會在發生驗證錯誤時出現預設錯誤樣板，提供使用者視覺化的回應。如需詳細資訊，請參閱資料繫結概觀中的＜資料驗證＞。除此之外，WPF 提供的內建驗證規則，會攔截繫結來源屬性更新期間所擲回的例外狀況。如需詳細資訊，請參閱 ExceptionValidationRule。

共用方式為

HOW TO：實作繫結驗證

範例

請參閱

概念

其他資源

其他資源