Binding.ElementName Свойство

Определение

Пространство имен:
Microsoft.UI.Xaml.Data
Изменить

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

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 . Полный список кода см. в примере привязки данных XAML в сценарии 1.

<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, почти всегда включают простой путь , который называет свойство, существующее в объекте, на который ссылается объект. Обычно исходное свойство из именованного элемента и целевого свойства в целевом объекте имеет то же имя и использует тот же тип значения, это сценарий, который довольно часто отображается в определениях шаблонов элементов управления, которые составные элементы управления, но свойства поверхности из частей. Если свойства источника и назначения используют разные типы, укажите значение преобразователя , которое может устранить разницу типов и вернуть соответствующее значение для назначения.

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

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

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

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

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