Binding.Path Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Data

Obtiene o establece la ruta de acceso a la propiedad de origen de enlace.

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

PropertyPath Path();

void Path(PropertyPath value);

public PropertyPath Path { get; set; }

var propertyPath = binding.path;
binding.path = propertyPath;

Public Property Path As PropertyPath

<Binding Path="propertyPath"/>

Valor de propiedad

PropertyPath

Ruta de acceso de propiedad para el origen del enlace.

Ejemplos

En el código XAML siguiente se muestra cómo establecer la ruta de acceso mediante la extensión de marcado {Binding}. Para obtener la lista de código completa, consulta el ejemplo de enlace de datos XAML.

<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. -->
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

En el código XAML siguiente se muestra cómo establecer la ruta de acceso mediante indizadores enteros y de cadena. Para obtener la lista de código completa, consulta el ejemplo de enlace de datos XAML.

Nota:

Las extensiones de componentes de Visual C++ (C++/CX) no admiten actualmente el enlace del indexador. Consulte el ejemplo para obtener una solución alternativa.

<StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team name:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3].Name}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5" />

  </StackPanel>

  <StackPanel Orientation="Horizontal">

    <TextBlock Text="Team manager:" 
      Style="{StaticResource DescriptionTextStyle}" 
      Margin="5" FontWeight="Bold"/>

    <TextBlock Text="{Binding Path=[3][Gaffer]}" 
      Style="{StaticResource DescriptionTextStyle}" Margin="5"/>

  </StackPanel>

</StackPanel>

Comentarios

La ruta de acceso puede ser una propiedad directa del objeto de origen o subpropiedades de ese objeto al que atraviesa mediante la sintaxis de la ruta de acceso de propiedad. En el caso de los orígenes de datos de Microsoft .NET, las rutas de acceso también pueden usar una sintaxis del indexador para hacer referencia a elementos específicos de una colección. Para obtener más información sobre el formato de ruta de acceso de propiedad, consulte Sintaxis property-path.

Para establecer el origen de datos como el objeto Source , la ruta de acceso debe definirse con una cadena vacía ("").

Al usar la extensión de marcado {Binding}, el valor path se puede establecer con el argumento inmediatamente después de la {Binding parte del uso de la extensión, no es necesario incluir Path=explícitamente . Por ejemplo, {Binding Albums} establece el valor Path de ese enlace como PropertyPath construido a partir de la cadena "Albums" (no se establecen otras propiedades binding ).

La mayoría de los usos de Path implican establecer su valor. En escenarios en los que se obtiene el valor para examinar las propiedades de un enlace existente, el valor PropertyPath.Path contiene la cadena que representa la ruta de acceso.

No se pueden establecer los valores de propiedad de un objeto Binding después de que ese enlace se haya asociado a un elemento de destino y a una propiedad de destino. Si intenta esto, obtendrá una excepción en tiempo de ejecución.

Consulte también

• PropertyPath
• Ejemplo de enlace de datos XAML
• Enlace de datos en profundidad