UpdateSource Method
Collapse the table of content
Expand the table of content

BindingExpression.UpdateSource Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2017 Microsoft