BindingExpression.UpdateSource Method

Sends the current binding target value to the binding source property in TwoWay bindings.

Namespace:  System.Windows.Data
Assembly:  System.Windows (in System.Windows.dll)

Public Sub UpdateSource


The BindingExpression is detached from the binding target.

You can use this method to control when the data source is updated. This is useful, for example, to validate several controls together before you update their data sources.

The following code example demonstrates how to use this method.

<TextBox x:Name="textBox1" Text="{Binding Test, Mode=TwoWay, UpdateSourceTrigger=Explicit}" />
<Button Content="Update" Click="Button_Click" />

Public Class TestData
    Private testValue As String
    Public Property Test() As String
            Return testValue
        End Get
        Set(ByVal value As String)
            testValue = value
        End Set
    End Property
End Class

Private data As TestData

Public Sub New()


    data = New TestData
    With data
        .Test = "one"
    End With

    textBox1.DataContext = data

End Sub

Private Sub Button_Click(ByVal sender As Object, _
    ByVal e As RoutedEventArgs)

    Dim expression As BindingExpression = _
    MessageBox.Show("Before UpdateSource, Test = " & data.Test)
    MessageBox.Show("After UpdateSource, Test = " & data.Test)

End Sub


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions