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


Binding.ElementName Свойство

Определение

Возвращает или задает имя элемента, используемого в качестве источника привязки для привязки.

public:
 property Platform::String ^ ElementName { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring ElementName();

void ElementName(winrt::hstring value);
public string ElementName { get; set; }
var string = binding.elementName;
binding.elementName = string;
Public Property ElementName As String
<Binding ElementName="nameString"/>

Значение свойства

String

Platform::String

winrt::hstring

Значение свойства Name или атрибута x:Name для элемента, который требуется использовать в качестве источника привязки. Значением по умолчанию является пустая строка.

Примеры

В следующем примере кода показано, как установить двусторонняя привязка между Элементом управления TextBox и Slider . Полный листинг кода см. в сценарии 1 в примере привязки данных XAML.

<Slider x:Name="slider1" Minimum="1" Maximum="100"/>
<TextBox Text="{Binding ElementName=slider1, Path=Value, Mode=TwoWay}"/>

Комментарии

При установке этого свойства указанное значение должно ссылаться на элемент в одном из следующих расположений:

  • Текущая область имен XAML.
  • Область имен XAML шаблонного родительского элемента, если целевой объект привязки находится в шаблоне данных или шаблоне элемента управления. Из-за этого ограничения нельзя использовать свойство ElementName для привязки к элементам, которые не созданы с помощью XAML. Для привязки к элементам, созданным программным способом, используйте вместо него свойство Source . Source, RelativeSource и ElementName являются взаимоисключающими в привязке. Если вы задали один из этих атрибутов, установка одного из двух других атрибутов в привязке (с помощью XAML или кода) вызовет исключение.

Привязки, использующие значение ElementName, почти всегда включают простой путь , который называет свойство, существующее в объекте, на который ссылается ссылка. Как правило, свойство source из именованного элемента и целевое свойство в целевом объекте имеют одинаковое имя и используют один и тот же тип значения. Это сценарий, который вы довольно часто видите в определениях шаблонов элементов управления, что составные части элемента управления, но свойства поверхности из частей. Если свойства источника и назначения используют разные типы, укажите значение преобразователя , которое может разрешить разницу типов и вернуть соответствующее значение для назначения.

Дополнительные сведения о областях имен XAML и о том, как они влияют на привязки и другой программный доступ к объектам, созданным из XAML, см. в разделе Области имен XAML.

Значение ElementName технически может быть любой строкой, но значения атрибута Name и x:Name принудительно должны быть допустимыми в грамматике XamlName, поэтому вы обычно привязаны к этой грамматике для значения ElementName. Дополнительные сведения о допустимости имени элемента см. в разделе "Грамматика XamlName" в справочнике по атрибутам x:Name .

Нельзя задать значения свойств объекта Binding после присоединения привязки к целевому элементу и целевому свойству. При попытке вы получите исключение во время выполнения.

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

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