Практическое руководство. Управление обновлением источника из поля TextBox

Обновлен: Ноябрь 2007

В этом разделе описывает способы использования свойства UpdateSourceTrigger для контроля времени обновлений источника привязки. В разделе используется элемент управления TextBox в качестве примера.

Пример

Свойство TextBox. Text имеет значение UpdateSourceTriggerLostFocus по умолчанию. Это означает, что если приложение имеет TextBox с привязки к данным свойствам TextBox. Text, текст, вводимый вами в TextBox, не обновляет источник до тех пор, пока TextBox не потеряет фокус (например, если щелкнуть мышью вне TextBox).

Если требуется, чтобы источник обновлялся при вводе, задайте UpdateSourceTrigger привязки к PropertyChanged. В следующем примере свойства Text и TextBox, и TextBlock связаны с теми же свойствами источника. Свойство UpdateSourceTrigger привязки TextBox устанавливается в значение PropertyChanged.

<Label>Enter a Name:</Label>
<TextBox>
  <TextBox.Text>
    <Binding Source="{StaticResource myDataSource}" Path="Name"
             UpdateSourceTrigger="PropertyChanged"/>
  </TextBox.Text>
</TextBox>

<Label>The name you entered:</Label>
<TextBlock Text="{Binding Source={StaticResource myDataSource}, Path=Name}"/>

В результате TextBlock отображает текст (поскольку источник изменяется), которой пользователь вводит в TextBox, как показано на следующем снимке экрана:

Полный пример содержится в разделе Простой пример привязки.

Если имеется диалоговое окно или редактируемая пользователем форма, и требуется отложить обновление источника до тех пор, пока пользователь не завершит редактирование поля и нажмет кнопку «ОК», то можно установить значение UpdateSourceTrigger привязки в Explicit, как в следующем примере:

<TextBox Name="itemNameTextBox"
         Text="{Binding Path=ItemName, UpdateSourceTrigger=Explicit}" />

Если задано значение UpdateSourceTrigger, равное Explicit, то значение источника изменится только тогда, когда приложение вызовет метод UpdateSource. В следующем примере показан способ вызова UpdateSource для itemNameTextBox:

Me.itemNameTextBox.GetBindingExpression(TextBox.TextProperty).UpdateSource()
Me.bidPriceTextBox.GetBindingExpression(TextBox.TextProperty).UpdateSource()

// itemNameTextBox is an instance of a TextBox
BindingExpression be = itemNameTextBox.GetBindingExpression(TextBox.TextProperty);
be.UpdateSource();

Полный пример содержится в разделе Пример явного обновления источника привязки.

Примечание.
Можно использовать одинаковые технологии для свойств других элементов управления, но следует помнить, что большинство других свойств имеют значения UpdateSourceTrigger для PropertyChanged по умолчанию. Дополнительные сведения см. в свойстве на странице свойства UpdateSourceTrigger.

Примечание.

Свойство UpdateSourceTrigger имеет дело с обновлениями источника и, таким образом, относится только к привязкам TwoWay или OneWay. Чтобы привязки TwoWay и OneWay работали, исходный объект должен предоставить уведомление об изменениях свойства. Можно обратиться к примеру в данном разделе для получения дополнительных сведений. Кроме того, можно посмотреть в Практическое руководство. Реализация уведомления об изменении свойства.

См. также

Другие ресурсы

Примеры привязки данных

Практические руководства по привязке данных