BindingGroup.UpdateSources メソッド

定義

名前空間:

System.Windows.Data

アセンブリ:

PresentationFramework.dll

バインディングおよび ValidationRule プロパティが ValidationStep、RawProposedValue、または ConvertedProposedValue に設定されている UpdatedValue オブジェクトに対してコンバーターを実行し、すべての検証ルールが成功した場合は、ターゲットの値をソース オブジェクトに保存します。

public:
 bool UpdateSources();

public bool UpdateSources ();

member this.UpdateSources : unit -> bool

Public Function UpdateSources () As Boolean

戻り値

Boolean

すべての検証ルールが成功した場合は true。それ以外の場合は false。

例

次の例は、複数の顧客を入力し、各顧客に営業担当者を割り当てるようユーザーに求めるアプリケーションの一部です。 アプリケーションは、営業担当者と顧客が同じリージョンに属していることを確認します。 この例では、バインドを検証し、すべての検証規則が成功した場合にソースに値を保存する呼び出し UpdateSources を行います。

void saveCustomer_Click(object sender, RoutedEventArgs e)
{
    Button btn = sender as Button;
    FrameworkElement container = (FrameworkElement) customerList.ContainerFromElement(btn);

    // If the user is trying to change an items, when another item has an error,
    // display a message and cancel the currently edited item.
    if (bindingGroupInError != null && bindingGroupInError != container.BindingGroup)
    {
        MessageBox.Show("Please correct the data in error before changing another customer");
        container.BindingGroup.CancelEdit();
        return;
    }

    if (container.BindingGroup.UpdateSources())
    {
        bindingGroupInError = null;
        MessageBox.Show("Item Saved");
    }
    else
    {
        bindingGroupInError = container.BindingGroup;
    }
}

Private Sub saveCustomer_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim btn As Button = TryCast(sender, Button)
    Dim container As FrameworkElement = CType(customerList.ContainerFromElement(btn), FrameworkElement)

    ' If the user is trying to change an items, when another item has an error,
    ' display a message and cancel the currently edited item.
    If bindingGroupInError IsNot Nothing AndAlso bindingGroupInError IsNot container.BindingGroup Then
        MessageBox.Show("Please correct the data in error before changing another customer")
        container.BindingGroup.CancelEdit()
        Return
    End If

    If container.BindingGroup.UpdateSources() Then
        bindingGroupInError = Nothing
        MessageBox.Show("Item Saved")
    Else
        bindingGroupInError = container.BindingGroup
    End If

End Sub

注釈

このメソッドは、すべての ValidationRule 成功が成功した場合にソースを更新しますが、ソースが保留中の変更をコミットして編集トランザクションを終了することはありません。 つまり、ソース オブジェクトが実装されている場合です IEditableObject。 このメソッドを呼び出しても、 EndEdit 呼び出されることはありません。 このメソッドを CommitEdit 使用して、ソースに保留中の変更をコミットさせます。