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, целевой объект — TextBox, целевое свойство — Text свойство , используемое значение — 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

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

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

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

Поля

DoNothing	Используется в качестве возвращаемого значения для указания подсистеме привязки не выполнять никаких действий.
IndexerName	Используется как PropertyName из PropertyChangedEventArgs, указывая, что свойство индексатора изменилось.
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.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetXmlNamespaceManager(DependencyObject)	Возвращает объект диспетчера пространства имен XML, используемый привязкой, присоединенной к указанному объекту.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
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.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

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

Применяется к

Поделиться через