Расширение разметки {Binding}

Расширение разметки {Binding} используется для привязки свойств данных к элементам управления, поступающим из источника данных, например кода. Расширение разметки {Binding} преобразуется во время загрузки XAML в экземпляр класса Binding. Этот объект привязки получает значение из свойства источника данных и отправляет его в свойство элемента управления. Объект привязки можно настроить для наблюдения за изменениями в значении свойства источника данных и обновляться на основе этих изменений. Кроме того, его можно настроить для отправки изменений в значение элемента управления обратно в исходное свойство. Свойство, которое является целевым объектом привязки данных, должно быть свойством зависимостей. Дополнительные сведения см. в разделе "Общие сведения о свойствах зависимостей".

{Binding} имеет тот же приоритет свойства зависимостей, что и локальное значение, и установка локального значения в императивном коде удаляет эффект любого набора {Binding} в разметке.

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

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Путь к свойству

Путь описывает свойство, к которому вы привязываетесь (исходное свойство). Путь — это позиционный параметр, который означает, что можно явно использовать имя параметра ({Binding Path=EmployeeID}) или указать его как первый неименованный параметр ({Binding EmployeeID}).

Тип Path — это путь к свойству, который представляет собой строку, которая оценивается свойством или под свойством пользовательского типа или типа платформы. Тип может быть, но не должен быть, зависимостьObject. Этапы в пути к свойству разделены точками (.), и вы можете добавить несколько разделителей для прохождения по иерархии. Используйте разделительные точки независимо от языка программирования, используемого для реализации объекта, к которому осуществляется привязка.

Например, чтобы привязать пользовательский интерфейс к свойству имени объекта employee, путь к свойству может иметь значение Employee.FirstName. Если бы элемент управления элементами привязывался к свойству, содержащему подчиненных сотрудников, то путем свойства мог бы быть Employee.Dependents, а шаблон элемента управления элементами, отобразил бы элементы в Dependents.

Если источником данных выступает коллекция, то в пути свойства можно указывать элементы коллекции по их позиции или индексу. Например, "Teams[0]. Проигрыватели, где литерал "[]" заключает "0", указывающий первый элемент в коллекции.

При использовании привязки ElementName к существующему объекту DependencyObject можно использовать присоединенные свойства в рамках пути к свойству. Чтобы отсоединить присоединенное свойство, чтобы промежуточная точка в имени присоединенного свойства не считалась шагом в пути к свойству, помещайте скобки вокруг имени присоединенного свойства владельца; например, (AutomationProperties.Name).

Промежуточный объект пути свойства хранится как объект PropertyPath в представлении времени выполнения, но большинство сценариев не нужно взаимодействовать с объектом PropertyPath в коде. Обычно можно указать необходимые сведения о привязке с помощью XAML.

Дополнительные сведения о синтаксисе строки для пути свойства, пути свойств в областях функций анимации и создании объекта PropertyPath см . в синтаксисе Property-path.

Свойства класса Binding, который можно задать с помощью {Binding}

{Binding} иллюстрируется синтаксисом заполнителя bindingProperties, так как в расширении разметки можно задать несколько свойств чтения и записи привязки. Свойства можно задавать в любом порядке с парами propName=value, разделенными запятыми. Для некоторых свойств требуются типы, которые не имеют преобразования типов, поэтому для них требуются расширения разметки собственных вложенных в {Binding}.

Обратите внимание, что при преобразовании разметки из {x:Bind} в {Binding}следует учитывать различия в значениях по умолчанию для свойства Mode.

Converter, ConverterLanguage и ConverterLanguage связаны с сценарием преобразования значения или типа из источника привязки в тип или значение, совместимые со свойством цели привязки. Более подробную информацию и примеры см. в разделе "Преобразования данных" статьи Подробно о привязке данных.

Источник, RelativeSource и ElementName указывают источник привязки, поэтому они являются взаимоисключающими.

Совет, если необходимо указать одну фигурную фигурную скобку для значения, например в Path или ConverterParameter, а затем предшествуйте ей обратную косую черту: \{ Также можно включить всю строку, содержащую скобки, которые нужно преобразовать, в дополнительный набор кавычек, например: ConverterParameter='{Mix}'.

Примеры

<!-- binding a UI element to a view model -->    
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

Второй пример задает четыре различных свойства привязки: ElementName, Path, Mode и Converter. Путь в этом случае отображается явным образом как свойство Binding . Путь вычисляется в источнике привязки данных, который является другим объектом в том же дереве объектов во время выполнения, ползунок с именемsliderValueConverter.

Обратите внимание, что значение свойства Конвертера использует другое расширение разметки , расширение разметки {StaticResource}, поэтому здесь используются два вложенных расширения разметки. Сначала вычисляется внутренняя, поэтому после получения ресурса есть практический IValueConverter (настраиваемый класс, созданный элементом local:S2Formatter в ресурсах), который может использовать привязку.

Поддержка средств

Microsoft IntelliSense в Microsoft Visual Studio отображает свойства контекста данных при создании {Binding} в редакторе разметки XAML. Как только вы введите "{Binding", свойства контекста данных, соответствующие path , отображаются в раскрывающемся списке. IntelliSense также помогает с другими свойствами Привязки. Для этого необходимо иметь контекст данных или контекст данных во время разработки на странице разметки. Перейти к определению (F12) также работает с {Binding}. Кроме того, можно использовать диалоговое окно привязки данных.