BindingGroup Klasse

Definition

public ref class BindingGroup : System::Windows::DependencyObject

public class BindingGroup : System.Windows.DependencyObject

type BindingGroup = class
    inherit DependencyObject

Public Class BindingGroup
Inherits DependencyObject

Vererbung

Object

DispatcherObject

DependencyObject

BindingGroup

Beispiele

Die folgenden Beispiele erstellen eine Anwendung, die den Benutzer auffordert, die Beschreibung und den Preis eines Artikels und das Datum einzugeben, an dem das Angebot abläuft. Die Anwendung zeigt die aktuellen Informationen für das Element unterhalb des Formulars an. Der Benutzer kann die Änderungen übermitteln oder abbrechen.

Die Anwendung führt die folgenden Schritte aus, um dieses Verhalten zu erzielen.

• Erstellt ein Und BindingGroup fügt es den Stamm StackPanel hinzu, wenn er die Benutzeroberfläche der Anwendung erstellt.

• Aufrufe BeginEdit, , CommitEditund CancelEdit in der Logik der Anwendung, um das Rollback von Änderungen zu ermöglichen.

• Ruft TryGetValue in einer Validate Methode auf, um die Eingabe des Benutzers abzurufen und dann zu überprüfen, ob ein Element über 100 Dollar für mindestens sieben Tage verfügbar ist.

Im folgenden Beispiel wird die Benutzeroberfläche der Anwendung erstellt. Der Stamm StackPanel verfügt über ein BindingGroupValidationRule Element, das das Element überprüft, wie zuvor beschrieben. Die Bindungsobjekte für die Price Eigenschaft und die OfferExpires Eigenschaft werden Teil der BindingGroup und jede Bindung hat eine ValidationRule , um sicherzustellen, dass Preis und Datum gültige Werte sind. Die Gültigkeitsprüfungsregeln für die einzelnen Eigenschaften werden vor der Ausführung auf der ValidationRuleBindingGroup.

<StackPanel Name="stackPanel1"  Margin="10" Width="250"
            Loaded="stackPanel1_Loaded"
            Validation.Error="ItemError">

  <StackPanel.Resources>
    <Style TargetType="HeaderedContentControl">
      <Setter Property="Margin" Value="2"/>
      <Setter Property="Focusable" Value="False"/>
      <Setter Property="Template">
        <Setter.Value>
          <ControlTemplate TargetType="HeaderedContentControl">
            <DockPanel LastChildFill="False">
              <ContentPresenter ContentSource="Header" DockPanel.Dock="Left" Focusable="False" VerticalAlignment="Center"/>
              <ContentPresenter ContentSource="Content" Margin="5,0,0,0" DockPanel.Dock="Right" VerticalAlignment="Center"/>
            </DockPanel>

          </ControlTemplate>
        </Setter.Value>
      </Setter>
    </Style>

    <Style TargetType="Button">
      <Setter Property="Width" Value="100"/>
      <Setter Property="Margin" Value="10,15,15,15"/>

    </Style>

  </StackPanel.Resources>
  
  <StackPanel.BindingGroup>
    <BindingGroup NotifyOnValidationError="True">
      <BindingGroup.ValidationRules>
        <src:ValidateDateAndPrice ValidationStep="ConvertedProposedValue" />
      </BindingGroup.ValidationRules>
    </BindingGroup>
  </StackPanel.BindingGroup>
  
  <TextBlock FontSize="14" Text="Enter an item for sale"/>
  <HeaderedContentControl Header="Description">
    <TextBox Width="150" Text="{Binding Path=Description, Mode=TwoWay}"/>
  </HeaderedContentControl>
  <HeaderedContentControl Header="Price">
    <TextBox Name="priceField"  Width="150">
      <TextBox.Text>
        <Binding Path="Price" Mode="TwoWay" >
          <Binding.ValidationRules>
            <src:PriceIsAPositiveNumber/>
          </Binding.ValidationRules>
        </Binding>
      </TextBox.Text>
    </TextBox>
  </HeaderedContentControl>
  <HeaderedContentControl Header="Date Offer Ends">
    <TextBox Name="dateField" Width="150" >
      <TextBox.Text>
        <Binding Path="OfferExpires" StringFormat="d" >
          <Binding.ValidationRules>
            <src:FutureDateRule/>
          </Binding.ValidationRules>
        </Binding>
      </TextBox.Text>
    </TextBox>
  </HeaderedContentControl>
  <StackPanel Orientation="Horizontal">
    <Button IsDefault="True" Click="Submit_Click">_Submit</Button>
    <Button IsCancel="True" Click="Cancel_Click">_Cancel</Button>
  </StackPanel>
  <HeaderedContentControl Header="Description">
    <TextBlock Width="150" Text="{Binding Path=Description}"/>
  </HeaderedContentControl>
  <HeaderedContentControl Header="Price">
    <TextBlock Width="150" Text="{Binding Path=Price, StringFormat=c}"/>
  </HeaderedContentControl>
  <HeaderedContentControl Header="Date Offer Ends">
    <TextBlock Width="150" Text="{Binding Path=OfferExpires, StringFormat=d}"/>
  </HeaderedContentControl>
</StackPanel>

Das folgende Beispiel zeigt die Ereignishandler für die Anwendung. Wenn der Benutzer auf die Schaltfläche "Absenden" klickt, ruft CommitEdit die Anwendung auf, um jede ValidationRule auszuführen, die der BindingGroupSchaltfläche zugeordnet ist. Wenn die ValidationRule Einzelnen erfolgreich sind, CommitEdit werden die Werte im Objekt gespeichert und die Bearbeitungstransaktion beendet. Wenn CommitEdit die Anwendung erfolgreich ist, beginnt die Anwendung eine weitere Bearbeitungstransaktion. Wenn ein ValidationRule Fehler auftritt, tritt das Validation.Error Ereignis auf, da die Anwendung auf das BindingGroup (im vorherigen Beispiel) festgelegt NotifyOnValidationErrortrue ist. ItemError behandelt das Validation.Error Ereignis und zeigt Dem Benutzer Informationen zum Überprüfungsfehler an. Im Beispiel wird auch das Loaded Ereignis für das StackPanel Ereignis und das Click Ereignis für die Schaltfläche "Abbrechen " behandelt.

private void Submit_Click(object sender, RoutedEventArgs e)
{
    if (stackPanel1.BindingGroup.CommitEdit())
    {
        MessageBox.Show("Item submitted");
        stackPanel1.BindingGroup.BeginEdit();
    }
}

// This event occurs when a ValidationRule in the BindingGroup
// or in a Binding fails.
private void ItemError(object sender, ValidationErrorEventArgs e)
{
    if (e.Action == ValidationErrorEventAction.Added)
    {
        MessageBox.Show(e.Error.ErrorContent.ToString());
    }
}

void stackPanel1_Loaded(object sender, RoutedEventArgs e)
{
    // Set the DataContext to a PurchaseItem object.
    // The BindingGroup and Binding objects use this as
    // the source.
    stackPanel1.DataContext = new PurchaseItem();

    // Begin an edit transaction that enables
    // the object to accept or roll back changes.
    stackPanel1.BindingGroup.BeginEdit();
}

private void Cancel_Click(object sender, RoutedEventArgs e)
{
    // Cancel the pending changes and begin a new edit transaction.
    stackPanel1.BindingGroup.CancelEdit();
    stackPanel1.BindingGroup.BeginEdit();
}

Private Sub Submit_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    If stackPanel1.BindingGroup.CommitEdit() Then
        MessageBox.Show("Item submitted")
        stackPanel1.BindingGroup.BeginEdit()
    End If


End Sub

' This event occurs when a ValidationRule in the BindingGroup
' or in a Binding fails.
Private Sub ItemError(ByVal sender As Object, ByVal e As ValidationErrorEventArgs)
    If e.Action = ValidationErrorEventAction.Added Then
        MessageBox.Show(e.Error.ErrorContent.ToString())

    End If
End Sub

Private Sub stackPanel1_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Set the DataContext to a PurchaseItem object.
    ' The BindingGroup and Binding objects use this as
    ' the source.
    stackPanel1.DataContext = New PurchaseItem()

    ' Begin an edit transaction that enables
    ' the object to accept or roll back changes.
    stackPanel1.BindingGroup.BeginEdit()
End Sub

Private Sub Cancel_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Cancel the pending changes and begin a new edit transaction.
    stackPanel1.BindingGroup.CancelEdit()
    stackPanel1.BindingGroup.BeginEdit()
End Sub

Das folgende Beispiel zeigt den Benutzerdefinierten ValidationRuleValidateDateAndPrice, der BindingGroup im ersten Beispiel hinzugefügt wurde. Die ValidationRule methode verwendet die BindingGroup in Validate der Methode, um die Werte abzurufen, die der Benutzer in das Formular eingegeben hat, und überprüft, ob ein Element über 100 Dollar liegt, es für mindestens sieben Tage verfügbar ist.

public class ValidateDateAndPrice : ValidationRule
{
    // Ensure that an item over $100 is available for at least 7 days.
    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        BindingGroup bg = value as BindingGroup;

        // Get the source object.
        PurchaseItem item = bg.Items[0] as PurchaseItem;
        
        object doubleValue;
        object dateTimeValue;

        // Get the proposed values for Price and OfferExpires.
        bool priceResult = bg.TryGetValue(item, "Price", out doubleValue);
        bool dateResult = bg.TryGetValue(item, "OfferExpires", out dateTimeValue);

        if (!priceResult || !dateResult)
        {
            return new ValidationResult(false, "Properties not found");
        }

        double price = (double)doubleValue;
        DateTime offerExpires = (DateTime)dateTimeValue;

        // Check that an item over $100 is available for at least 7 days.
        if (price > 100)
        {
            if (offerExpires < DateTime.Today + new TimeSpan(7, 0, 0, 0))
            {
                return new ValidationResult(false, "Items over $100 must be available for at least 7 days.");
            }
        }

        return ValidationResult.ValidResult;
    }
}

Public Class ValidateDateAndPrice
    Inherits ValidationRule
    ' Ensure that an item over $100 is available for at least 7 days.
    Public Overrides Function Validate(ByVal value As Object, ByVal cultureInfo As CultureInfo) As ValidationResult
        Dim bg As BindingGroup = TryCast(value, BindingGroup)

        ' Get the source object.
        Dim item As PurchaseItem = TryCast(bg.Items(0), PurchaseItem)

        Dim doubleValue As Object = Nothing
        Dim dateTimeValue As Object = Nothing

        ' Get the proposed values for Price and OfferExpires.
        Dim priceResult As Boolean = bg.TryGetValue(item, "Price", doubleValue)
        Dim dateResult As Boolean = bg.TryGetValue(item, "OfferExpires", dateTimeValue)

        If (Not priceResult) OrElse (Not dateResult) Then
            Return New ValidationResult(False, "Properties not found")
        End If

        Dim price As Double = CDbl(doubleValue)
        Dim offerExpires As Date = CDate(dateTimeValue)

        ' Check that an item over $100 is available for at least 7 days.
        If price > 100 Then
            If offerExpires < Date.Today + New TimeSpan(7, 0, 0, 0) Then
                Return New ValidationResult(False, "Items over $100 must be available for at least 7 days.")
            End If
        End If

        Return ValidationResult.ValidResult

    End Function
End Class

Hinweise

Eine BindingGroup erstellt eine Beziehung zwischen mehreren Bindungen, die zusammen überprüft und aktualisiert werden können. Angenommen, eine Anwendung fordert den Benutzer auf, eine Adresse einzugeben. Die Anwendung füllt dann ein Objekt vom Typ Address, das die Eigenschaften, Street, , City, ZipCodeund , mit Countryden Werten enthält, die der Benutzer bereitgestellt hat. Die Anwendung verfügt über ein Panel mit vier TextBox Steuerelementen, von denen jede Daten an eine der Eigenschaften des Objekts gebunden ist. Sie können ein Objekt in einer ValidationRuleBindingGroup Datei verwenden, um das Address Objekt zu überprüfen. Wenn sich die Bindungen am gleichen BindingGroupBindungen beteiligen, können Sie sicherstellen, dass die Postleitzahl für das Land/die Region der Adresse gültig ist.

Sie legen die BindingGroup Eigenschaft auf FrameworkElement oder FrameworkContentElement. Untergeordnete Elemente erben die BindingGroup von ihren übergeordneten Elementen, genauso wie bei jeder anderen vererbbaren Eigenschaft. Einer der folgenden Situationen wird eine Bindung für ein untergeordnetes Element hinzugefügt BindingGroup :

• Die Quelle der Bindung und das DataContext Element, das das BindingGroup gleiche Objekt aufweist, und die BindingGroupName Eigenschaft wird nicht festgelegt.

• Die BindingGroupName Eigenschaft der Bindung ist gleich dem Name der BindingGroup Bindung, und sie werden nicht explizit auf null.

Gehen Sie im Beispiel der Adresse davon aus, dass das DataContextPanel Objekt des Typs Addressfestgelegt ist. Die Bindung für jede TextBox wird dem BindingGroup Panel hinzugefügt.

Sie fügen einem Objekt Objekte hinzu ValidationRuleBindingGroup. Der BindingGroup Parameter wird beim Ausführen als erster Parameter der Validate Methode ValidationRule übergeben. Sie können dazu die TryGetValue vorgeschlagenen Werte des Objekts und GetValue(Object, String)BindingGroup die Items Eigenschaft verwenden, um die Quellen der Bindungen abzurufen.

Eine BindingGroup Aktualisierung der Quellen der Bindung gleichzeitig, anstatt jede Bindung separat zu aktualisieren. Wenn Sie eine der Methoden zum Überprüfen der Daten (ValidateWithoutUpdate, oder CommitEdit) aufrufen, UpdateSourceswird die Bindung für jedes TextBox Beispiel überprüft und potenziell aktualisiert. Wenn eine Bindung Teil einer BindingGroupBindung ist, wird die Quelle der Bindung erst aktualisiert, wenn Sie UpdateSources die Eigenschaft explizit festlegenUpdateSourceTrigger.CommitEditBindingGroup