FrameworkElement.BindingGroup 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

取得或設定用於項目的 BindingGroup。

C#

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public System.Windows.Data.BindingGroup BindingGroup { get; set; }

屬性值

BindingGroup

用於項目的 BindingGroup。

屬性

LocalizabilityAttribute

範例

下列範例是應用程式的一部分，會檢查使用者是否已將兩個 物件的屬性設定為相等值。 第一個範例會建立兩 TextBox 個控制項，每個控制項都系結至不同的資料來源。 StackPanel具有 BindingGroup ，其中包含檢查兩個 ValidationRule 字串是否相等的 。

XAML

<StackPanel>
  <StackPanel.Resources>
    <src:Type1 x:Key="object1" />
    <src:Type2 x:Key="object2" />
  </StackPanel.Resources>

  <StackPanel Name="sp1"
              Margin="5"
              DataContext="{Binding Source={StaticResource object1}}"
              Validation.ValidationAdornerSite="{Binding ElementName=label1}"
              Orientation="Horizontal"
              HorizontalAlignment="Center">

    <StackPanel.BindingGroup>
      <BindingGroup Name="bindingGroup">
        <BindingGroup.ValidationRules>
          <src:BindingGroupValidationRule ValidatesOnTargetUpdated="True" />
        </BindingGroup.ValidationRules>
      </BindingGroup>
    </StackPanel.BindingGroup>

    <TextBlock Text="First string" />

    <TextBox Width="150"
             Text="{Binding Path=PropertyA}" />

    <TextBlock Text="Second string" />

    <TextBox Width="150"
             Text="{Binding Source={StaticResource object2}, 
      Path=PropertyB, BindingGroupName=bindingGroup, 
      TargetNullValue=please enter a string}" />

  </StackPanel>

  <Label Name="label1"
         Content="{Binding ElementName=sp1, Path=(Validation.Errors)[0].ErrorContent}"
         Margin="5"
         Foreground="Red"
         HorizontalAlignment="Center" />

  <Button HorizontalAlignment="Center"
          Click="Button_Click"
          IsDefault="True">
    _Submit
  </Button>

  <StackPanel Orientation="Horizontal">
    <TextBlock Text="First string:"
               FontWeight="Bold" />
    <TextBlock Text="{Binding Source={StaticResource object1}, 
      Path=PropertyA, TargetNullValue=--}" />
  </StackPanel>

  <StackPanel Orientation="Horizontal">
    <TextBlock Text="Second string:"
               FontWeight="Bold" />
    <TextBlock Text="{Binding Source={StaticResource object2}, 
      Path=PropertyB, TargetNullValue=--}" />
  </StackPanel>
</StackPanel>

下列範例顯示 ValidationRule 上一個範例所使用的 。 在 Validate 方法覆寫中，此範例會從 BindingGroup 取得每個來源物件，並檢查物件的屬性是否相等。

C#

public class Type1
{
    public string PropertyA { get; set; }

    public Type1()
    {
        PropertyA = "Default Value";
    }
}

public class Type2
{
    public string PropertyB { get; set; }

    public Type2()
    {
    }
}

public class BindingGroupValidationRule : ValidationRule
{
    public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
    {
        BindingGroup bg = value as BindingGroup;

        Type1 object1 = null;
        Type2 object2 = null;

        foreach (object item in bg.Items)
        {
            if (item is Type1)
            {
                object1 = item as Type1;
            }

            if (item is Type2)
            {
                object2 = item as Type2;
            }
        }

        if (object1 == null || object2 == null)
        {
            return new ValidationResult(false, "BindingGroup did not find source object.");
        }

        string string1 = bg.GetValue(object1, "PropertyA") as string;
        string string2 = bg.GetValue(object2, "PropertyB") as string;

        if (string1 != string2)
        {
            return new ValidationResult(false, "The two strings must be identical.");
        }

        return ValidationResult.ValidResult;
    }
}

若要叫用 ValidationRule ，請呼叫 UpdateSources 方法。 下列範例會在按鈕的 click 事件發生時呼叫 UpdateSources 。

C#

private void Button_Click(object sender, RoutedEventArgs e)
{
    sp1.BindingGroup.UpdateSources();
}

備註

BindingGroup可用來驗證 物件之多個屬性的值。 例如，假設應用程式會提示使用者輸入位址，然後填入類型的 Address 物件，其具有使用者所提供的值、 City 、 ZipCode 和 Country 屬性 Street 。 應用程式有一個面板，其中包含四 TextBox 個控制項，每個控制項都系結至其中一個物件的屬性。 您可以在 中使用 ValidationRule BindingGroup 來驗證 Address 物件。 例如， ValidationRule 可以確保郵遞區號對位址的國家/地區有效。

子專案繼承 BindingGroup 自其父元素，就像任何其他可繼承的屬性一樣。

相依性屬性資訊

識別碼欄位	BindingGroupProperty
中繼資料屬性設定為 true	Inherits

適用於