Binding.Path Propiedad

Definición

Obtiene o establece la ruta de acceso a la propiedad de origen de enlace.Gets or sets the path to the binding source property.

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

Valor de propiedad

Ruta de acceso al origen de enlace.The path to the binding source. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo siguiente se muestra un desencadenador de ToolTip estilo que crea un que informa de un mensaje de error de validación.The following example shows a style trigger that creates a ToolTip that reports a validation error message. El valor del establecedor se enlaza con el contenido del error del actual TextBox TextBox (con el estilo) mediante la RelativeSource propiedad.The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Para obtener más información sobre este ejemplo, consulte Cómo: Implementar la validacióndel enlace.For more information on this example, see How to: Implement Binding Validation.

<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>

Comentarios

Cada enlace tiene normalmente estos cuatro componentes: un objeto de destino de enlace, una propiedad de destino, un origen de enlace y una ruta de acceso al valor del origen de enlace que se va a usar.Each binding typically has these four components: a binding target object, a target property, a binding source, and a path to the value in the binding source to use. Para obtener más información sobre estos conceptos de enlace de datos, vea información generalsobre el enlace de datos.For more information about these data binding concepts, see Data Binding Overview.

Use la Path propiedad para especificar el valor de origen al que desea enlazar:Use the Path property to specify the source value you want to bind to:

  • En el caso más simple, el Path valor de la propiedad es el nombre de la propiedad del objeto de origen que se va a usar para Path=PropertyNameel enlace, como.In the simplest case, the Path property value is the name of the property of the source object to use for the binding, such as Path=PropertyName.

  • Las subpropiedades de una propiedad se pueden especificar mediante una sintaxis similar a la C#que se usa en.Subproperties of a property can be specified by a syntax similar to that used in C#. Por ejemplo, la cláusula Path=ShoppingCart.Order define el enlace a la subpropiedad Order del objeto o la propiedad ShoppingCart.For instance, the clause Path=ShoppingCart.Order sets the binding to the subproperty Order of the object or property ShoppingCart.

  • Para enlazar a una propiedad adjunta, coloque paréntesis alrededor de esta propiedad.To bind to an attached property, place parentheses around the attached property. Por ejemplo, para enlazar a la propiedad DockPanel.Dockadjunta, la sintaxis Path=(DockPanel.Dock)es.For example, to bind to the attached property DockPanel.Dock, the syntax is Path=(DockPanel.Dock).

  • Los indizadores de una propiedad pueden especificarse entre corchetes después del nombre de la propiedad donde se aplica el indizador.Indexers of a property can be specified within square brackets following the property name where the indexer is applied. Por ejemplo, la cláusula Path=ShoppingCart[0] establece el enlace al índice que se corresponde a cómo la indización interna de la propiedad administra la cadena literal "0".For instance, the clause Path=ShoppingCart[0] sets the binding to the index that corresponds to how your property's internal indexing handles the literal string "0". También se admiten varios indexadores.Multiple indexers are also supported.

  • Los indizadores y las subpropiedades se pueden combinar en una cláusula Path; por ejemplo, Path=ShoppingCart.ShippingInfo[MailingAddress,Street]..Indexers and subproperties can be mixed in a Path clause; for example, Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

  • Dentro de los indexadores puede tener varios parámetros de indizador separados por comas (,).Inside indexers you can have multiple indexer parameters separated by commas (,). El tipo de cada parámetro se puede especificar entre paréntesis.The type of each parameter can be specified with parentheses. Por ejemplo, puede tener Path="[(sys:Int32)42,(sys:Int32)24]", donde sys se asigna al System espacio de nombres.For example, you can have Path="[(sys:Int32)42,(sys:Int32)24]", where sys is mapped to the System namespace.

  • Cuando el origen es una vista de colección, el elemento actual se puede especificar con una barra diagonal (/).When the source is a collection view, the current item can be specified with a slash (/). Por ejemplo, la cláusula Path=/ establece el enlace con el elemento actual de la vista.For example, the clause Path=/ sets the binding to the current item in the view. Cuando el origen es una colección, esta sintaxis especifica el elemento actual de la vista de colección predeterminada.When the source is a collection, this syntax specifies the current item of the default collection view.

  • Los nombres de propiedad y las barras diagonales se pueden combinar para atravesar propiedades que son colecciones.Property names and slashes can be combined to traverse properties that are collections. Por ejemplo, Path=/Offices/ManagerName especifica el elemento actual de la colección de origen, que contiene Offices una propiedad que también es una colección.For example, Path=/Offices/ManagerName specifies the current item of the source collection, which contains an Offices property that is also a collection. Su elemento actual es un objeto que contiene una ManagerName propiedad.Its current item is an object that contains a ManagerName property.

  • Opcionalmente, se puede usar una ruta de acceso de punto (.) para enlazar con el origen actual.Optionally, a period (.) path can be used to bind to the current source. Por ejemplo, Text="{Binding}" es equivalente a Text="{Binding Path=.}".For example, Text="{Binding}" is equivalent to Text="{Binding Path=.}".

Para obtener información sobre la sintaxis de la ruta de acceso, vea información general sobre declaraciones de enlace o Sintaxis de PropertyPath de XAML.For information about path syntax, see Binding Declarations Overview or PropertyPath XAML Syntax.

Para XMLXML los enlaces, vea la XPath propiedad.For XMLXML bindings, see the XPath property.

Para enlazar a un objeto completo, no es necesario especificar la Path propiedad.To bind to an entire object, you do not need to specify the Path property. Para obtener más información, vea "especificar la ruta de acceso al valor" en información general sobre el enlace de datos.For more information, see "Specifying the Path to the Value" in Data Binding Overview.

Se aplica a