FrameworkElement.BindingGroup Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia BindingGroup element, który jest używany dla elementu.

C#

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

Wartość właściwości

BindingGroup

Element BindingGroup , który jest używany dla elementu.

Atrybuty

LocalizabilityAttribute

Przykłady

Poniższe przykłady są częścią aplikacji, która sprawdza, czy użytkownik ustawił właściwości dwóch obiektów na równe wartości. Pierwszy przykład tworzy dwie TextBox kontrolki, z których każda jest powiązana z innym źródłem danych. Element StackPanel zawiera ValidationRule elementBindingGroup, który sprawdza, czy dwa ciągi są równe.

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>

W poniższym przykładzie pokazano ValidationRule , że w poprzednim przykładzie użyto. W zastąpieniu Validate metody przykład pobiera każdy obiekt źródłowy z obiektu BindingGroup i sprawdza, czy właściwości obiektów są równe.

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;
    }
}

Aby wywołać metodę , wywołaj metodę ValidationRuleUpdateSources . Poniższy przykład wywołuje wywołania UpdateSources po wystąpieniu zdarzenia kliknięcia przycisku.

C#

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

Uwagi

Element BindingGroup może służyć do sprawdzania poprawności wartości wielu właściwości obiektu. Załóżmy na przykład, że aplikacja monituje użytkownika o wprowadzenie adresu, a następnie wypełnia obiekt typu Address, który ma właściwości Street, City, ZipCodei Country, z wartościami podanymi przez użytkownika. Aplikacja ma panel zawierający cztery TextBox kontrolki, z których każda jest powiązana z jedną z właściwości obiektu. Możesz użyć elementu w obiekcie ValidationRuleBindingGroup , aby zweryfikować Address obiekt. Na przykład element ValidationRule może zagwarantować, że kod pocztowy jest prawidłowy dla kraju/regionu adresu.

Elementy podrzędne dziedziczą BindingGroup po swoich elementach nadrzędnych, podobnie jak w przypadku każdej innej właściwości dziedziczonej.

Informacje dotyczące właściwości zależności

Pole identyfikatora	BindingGroupProperty
Właściwości metadanych ustawione na true	Inherits

Dotyczy