Binding.Path Свойство

Определение

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

System.Windows.Data

Сборка:

PresentationFramework.dll

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

public:
 property System::Windows::PropertyPath ^ Path { System::Windows::PropertyPath ^ get(); void set(System::Windows::PropertyPath ^ value); };

public System.Windows.PropertyPath Path { get; set; }

member this.Path : System.Windows.PropertyPath with get, set

Public Property Path As PropertyPath

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

PropertyPath

Путь к источнику привязки. Значение по умолчанию — null.

Примеры

В следующем примере показан триггер стиля, который создает ToolTip сообщение об ошибке проверки. Значение метода задания привязывается к содержимому ошибки текущего TextBox ( TextBox используемого стиля) с помощью RelativeSource свойства. Дополнительные сведения об этом примере см. в статье "Практическое руководство. Реализация проверки привязки".

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Комментарии

Каждая привязка обычно имеет эти четыре компонента: целевой объект привязки, целевое свойство, источник привязки и путь к значению в источнике привязки для использования. Дополнительные сведения об этих понятиях привязки данных см. в разделе "Обзор привязки данных".

Используйте свойство, чтобы указать исходное Path значение, к которому нужно привязать:

• В самом простом случае Path значение свойства — это имя свойства исходного объекта, используемого для привязки, например Path=PropertyName.

• Вложенные свойства можно указать синтаксисом, аналогичным тому, который используется в C#. Например, предложение Path=ShoppingCart.Order задает привязку к подпродаче Order объекта или свойства ShoppingCart.

• Чтобы привязать к присоединенному свойству, поместите скобки вокруг присоединенного свойства. Например, для привязки к присоединенному свойству DockPanel.Dockиспользуется Path=(DockPanel.Dock)синтаксис.

• Индексаторы свойства можно указать в квадратных скобках после имени свойства, в котором применяется индексатор. Например, предложение Path=ShoppingCart[0] задает привязку индекса, соответствующего тому, как внутренний индексирование свойства обрабатывает литеральную строку "0". Также поддерживаются несколько индексаторов.

• Индексаторы и вложенные атрибуты могут быть смешанными в Path предложении, например: Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

• Внутри индексаторов можно использовать несколько параметров индексатора, разделенных запятыми (,). Тип каждого параметра можно указать с скобками. Например, можно иметь Path="[(sys:Int32)42,(sys:Int32)24]", где sys сопоставляется пространство System имен.

• Если источник является представлением коллекции, текущий элемент можно указать косой чертой (/). Например, предложение Path=/ задает привязку текущего элемента в представлении. Если источник является коллекцией, этот синтаксис указывает текущий элемент представления коллекции по умолчанию.

• Имена свойств и косая черта можно объединить для обхода свойств, которые являются коллекциями. Например, Path=/Offices/ManagerName указывает текущий элемент исходной коллекции, содержащий Offices свойство, которое также является коллекцией. Его текущий элемент — это объект, содержащий ManagerName свойство.

• При необходимости для привязки к текущему источнику можно использовать путь (.). Например, Text="{Binding}" является эквивалентом Text="{Binding Path=.}".

Сведения о синтаксисе пути см. в разделе "Общие сведения о объявлениях привязки " или " Синтаксис XAML PropertyPath".

Сведения о привязках XML см. в свойстве XPath .

Для привязки ко всему объекту не нужно указывать Path свойство. Дополнительные сведения см. в разделе "Указание пути к значению" в обзоре привязки данных.