Практическое руководство. Управление обновлением источника из поля 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 работали, исходный объект должен предоставить уведомление об изменениях свойства. Можно обратиться к примеру в данном разделе для получения дополнительных сведений. Кроме того, можно посмотреть в Практическое руководство. Реализация уведомления об изменении свойства. |