Binding Класс

Определение

Пространство имен:

System.Windows.Data

Сборка:

PresentationFramework.dll

Предоставляет высокий уровень доступа к определению привязки, которая подключает свойства целевых объектов привязки (обычно элементы WPF) и любой источник данных (например, базу данных, XML-файл или любой объект, содержащий данные).

public ref class Binding : System::Windows::Data::BindingBase

public class Binding : System.Windows.Data.BindingBase

type Binding = class
    inherit BindingBase

Public Class Binding
Inherits BindingBase

Наследование

Object

MarkupExtension

BindingBase

Binding

Комментарии

Привязка данных Windows Presentation Foundation (WPF) обеспечивает простой и согласованный способ представления и взаимодействия приложений с данными. Привязка данных позволяет синхронизировать значения свойств двух разных объектов.

Чтобы установить привязку, используйте Binding класс или один из других классов, наследуемых BindingBase. Независимо от того, какой объект является привязкой и характером источника данных, каждая привязка следует модели, показанной на следующем рисунке.

На рисунке показаны следующие основные понятия привязки данных WPF.

• Каждая привязка обычно имеет эти четыре компонента: целевой объект привязки, целевое свойство, источник привязки и Path значение в источнике привязки для использования. Например, если требуется привязать содержимое TextBox объекта Name объекта Employee, целевой объект — это свойство, целевое свойство — TextBoxText это свойство, используемое значение — Name, а исходный объект — объект Employee.

• Целевое свойство должно быть свойством зависимостей. Это также означает, что вы не можете привязать поле. Большинство свойств объектов — это свойства зависимостей и большинство свойств зависимостей, кроме доступных UIElement только для чтения, поддерживают привязку данных по умолчанию. (Только DependencyObject типы могут определять свойства зависимостей и все UIElement объекты, производные от DependencyObject.)

• Хотя не указано на рисунке, следует отметить, что исходный объект привязки не ограничен пользовательским объектом CLR. Привязка данных WPF поддерживает данные в виде объектов CLR и XML. Для предоставления некоторых примеров источник привязки может быть UIElementобъектом списка, объектом СРЕДЫ CLR, связанным с данными ADO.NET или веб-службами, или xmlNode, который содержит xml-данные.

Mode Используйте свойство, чтобы указать направление потока данных. Чтобы обнаружить изменения источника в одностороннем или двухстороннем привязках, источник должен реализовать подходящий механизм уведомления об изменении свойств, например INotifyPropertyChanged. Пример см. в разделе "Практическое руководство. Реализация уведомления об изменении свойств". Свойство UpdateSourceTrigger задает время обновления источника. Дополнительные сведения см. в разделе "Основные понятия привязки данных" в обзоре привязки данных.

Использование атрибута XAML

<object property="{Binding  declaration}"/>

Значения XAML

Декларации Ноль или более предложений назначения атрибутов, разделенных запятыми (,). Дополнительные сведения см. в разделе "Расширение разметки привязки " или "Объявления привязки".

Конструкторы

Имя	Описание
Binding()	Инициализирует новый экземпляр класса Binding.
Binding(String)	Инициализирует новый экземпляр Binding класса с начальным путем.

Поля

Имя	Описание
DoNothing	Используется в качестве возвращаемого значения для указания подсистеме привязки не выполнять никаких действий.
IndexerName	Используется в качестве PropertyNamePropertyChangedEventArgs указания на то, что свойство индексатора изменилось.
SourceUpdatedEvent	Определяет присоединенное SourceUpdated событие.
TargetUpdatedEvent	Определяет присоединенное TargetUpdated событие.
XmlNamespaceManagerProperty	Определяет присоединенное XmlNamespaceManager свойство.

Свойства

Имя	Описание
AsyncState	Возвращает или задает непрозрачные данные, передаваемые асинхронной диспетчеру данных.
BindingGroupName	Возвращает или задает имя BindingGroup , к которому принадлежит эта привязка. (Унаследовано от BindingBase)
BindsDirectlyToSource	Возвращает или задает значение, указывающее, следует ли оценивать Path относительно элемента данных или DataSourceProvider объекта.
Converter	Возвращает или задает используемый преобразователь.
ConverterCulture	Возвращает или задает язык и региональные параметры, в которых вычисляется преобразователь.
ConverterParameter	Возвращает или задает параметр для передачи Converterв .
Delay	Возвращает или задает время в миллисекундах, чтобы ждать, прежде чем обновлять источник привязки после значения в целевом изменении. (Унаследовано от BindingBase)
ElementName	Возвращает или задает имя элемента, используемого в качестве исходного объекта привязки.
FallbackValue	Возвращает или задает значение, используемое, если привязка не может возвращать значение. (Унаследовано от BindingBase)
IsAsync	Возвращает или задает значение, указывающее, следует ли Binding получать и задавать значения асинхронно.
Mode	Возвращает или задает значение, указывающее направление потока данных в привязке.
NotifyOnSourceUpdated	Возвращает или задает значение, указывающее, следует ли вызывать SourceUpdated событие при передаче значения из целевого объекта привязки в источник привязки.
NotifyOnTargetUpdated	Возвращает или задает значение, указывающее, следует ли вызывать TargetUpdated событие при передаче значения из источника привязки в целевой объект привязки.
NotifyOnValidationError	Возвращает или задает значение, указывающее, следует ли вызывать Error присоединенное событие в связанном объекте.
Path	Возвращает или задает путь к свойству источника привязки.
RelativeSource	Возвращает или задает источник привязки, указав его расположение относительно положения целевого объекта привязки.
Source	Возвращает или задает объект, используемый в качестве источника привязки.
StringFormat	Возвращает или задает строку, указывающую, как отформатировать привязку, если она отображает привязанное значение в виде строки. (Унаследовано от BindingBase)
TargetNullValue	Возвращает или задает значение, используемое в целевом объекте при значении nullисточника. (Унаследовано от BindingBase)
UpdateSourceExceptionFilter	Возвращает или задает обработчик, который можно использовать для предоставления пользовательской логики обработки исключений, возникающих подсистемой привязки во время обновления значения источника привязки. Это применимо только в том случае, если вы связали с привязкой ExceptionValidationRule .
UpdateSourceTrigger	Возвращает или задает значение, определяющее время обновления источника привязки.
ValidatesOnDataErrors	Возвращает или задает значение, указывающее, следует ли включать .DataErrorValidationRule
ValidatesOnExceptions	Возвращает или задает значение, указывающее, следует ли включать .ExceptionValidationRule
ValidatesOnNotifyDataErrors	Возвращает или задает значение, указывающее, следует ли включать .NotifyDataErrorValidationRule
ValidationRules	Возвращает коллекцию правил, проверяющих допустимость входных данных пользователя.
XPath	Возвращает или задает XPath запрос, возвращающий значение в источнике привязки XML для использования.

Присоединенные свойства

Имя	Описание
XmlNamespaceManager	Возвращает или задает используемый XmlNamespaceManager для выполнения запросов с поддержкой XPath пространства имен в XML-привязках.

Методы

Имя	Описание
AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Добавляет обработчик для присоединенного SourceUpdated события.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Добавляет обработчик для присоединенного TargetUpdated события.
GetXmlNamespaceManager(DependencyObject)	Возвращает объект диспетчера пространства имен XML, используемый привязкой, подключенной к указанному объекту.
ProvideValue(IServiceProvider)	Возвращает объект, который следует задать в свойстве, где применяется эта привязка и расширение. (Унаследовано от BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Удаляет обработчик для присоединенного SourceUpdated события.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Удаляет обработчик для присоединенного TargetUpdated события.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Задает объект диспетчера пространств имен, используемый привязкой, присоединенной к предоставленному элементу.
ShouldSerializeFallbackValue()	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать эффективное значение FallbackValue свойства в экземплярах этого класса. (Унаследовано от BindingBase)
ShouldSerializePath()	Указывает, следует ли Path сохранять свойство.
ShouldSerializeSource()	Указывает, следует ли Source сохранять свойство.
ShouldSerializeTargetNullValue()	Возвращает значение, указывающее, следует ли TargetNullValue сериализовать свойство. (Унаследовано от BindingBase)
ShouldSerializeValidationRules()	Указывает, следует ли ValidationRules сохранять свойство.

Присоединенные события

Имя	Описание
SourceUpdated	Происходит при передаче значения из целевого объекта привязки в источник привязки, но только для привязок с заданным trueзначениемNotifyOnSourceUpdated.
TargetUpdated	Происходит при передаче значения из источника привязки в целевой объект привязки, но только для привязок с заданным trueзначениемNotifyOnTargetUpdated.

См. также раздел

• MultiBinding
• PriorityBinding