PropertyPath.Path Propiedad

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

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

Valor de propiedad

Cadena que describe la ruta de acceso.

Comentarios

La cadena contenida en esta propiedad tiene tres significados completamente diferentes en función de si se usa para PropertyPath una ruta de acceso de propiedad en modo de origen para un enlace, para una ruta de acceso de propiedad de un solo paso en modo de destino para un destino de guión gráfico o para una ruta de acceso compleja para un destino de guión gráfico.

Si se usa en PropertyPath modo de origen para un enlace, Path es una cadena que representa un nombre de propiedad o puede ser una cadena que describe una ruta de acceso paso a paso a la propiedad en el modelo de objetos CLR del objeto que se usa como origen para un enlace. Para una ruta de acceso de propiedad de enlace, el carácter que identifica un "paso" es un punto (.). También se admiten las referencias del indexador (incluidos varios indexadores y diferenciación de tipos). Para obtener más información sobre la sintaxis de la cadena tal y como usa específicamente el Binding objeto, vea Binding.Path. Una propiedad usada como origen de enlace no debe ser una propiedad de dependencia. Si el enlace se actualiza bidireccionalmente, el origen de la propiedad debe ser de lectura y escritura. Tenga en cuenta también que el destino de enlace tiene que ser una propiedad de dependencia. Para obtener más información, consulte Información general del enlace de datos.

Si se usa en PropertyPath modo de destino para una ruta de acceso de un solo paso para un destino de guión gráfico, PropertyPath es una cadena que es un typeName.propertyName qualified dependency property name string.

Si se usa para PropertyPath una ruta de acceso compleja para un destino de guión gráfico, Path es un formato de cadena tokenizado que describe las relaciones de los distintos objetos proporcionados en .PathParameters

• El índice de matriz especifica cada elemento de la matriz en este formato para el elemento entre paréntesis. Por ejemplo, para especificar el primer elemento de la matriz, el token de cadena es (0).

• Las relaciones entre los elementos ("pasos" en la ruta de acceso) se especifican mediante un punto (.). La propiedad forward del punto es el primer paso de la ruta de acceso, la propiedad después de es el segundo paso, etc. (puede especificar pasos más allá de dos). El último paso de la cadena siempre representa la propiedad que se está animando.

• Se accede a los elementos dentro de las propiedades de la colección con una sintaxis de indexador, con el índice entre corchetes ([ y ]). El indexador se suma al token que representa la propiedad . Por ejemplo, la siguiente es una ruta de acceso de dos pasos, con la combinación de tokens en el primer paso que especifica el segundo elemento desde dentro de la colección de esa propiedad: (0)[1].(1) . No se puede usar un indexador en la última propiedad de la cadena; no puede animar la posición real de la colección, debe animar una propiedad en ese objeto.

La cadena de ruta de acceso de se PropertyPath establece normalmente a través de los constructores: la PropertyPath(Object) firma para enlaces o destinos de guion gráfico de un solo paso, la PropertyPath(String, Object[]) firma para los destinos de guion gráfico de varios pasos.

XAML: Cuando usas PropertyPath para describir una referencia de propiedad en XAML, como un valor de atributo, la cadena que especificas se controla primero mediante un convertidor de tipos (PropertyPathConverter). A continuación, este convertidor de tipos procesa la cadena y en función de su sintaxis llamará a una de las firmas del PropertyPath constructor. Esta direccionamiento indirecto a través del convertidor de tipos que controla un valor de atributo suele ser la forma en que se usa PropertyPath en XAML, en lugar de declarar un PropertyPath elemento de objeto y, a continuación, aplicar valores específicos a atributos como Path y PathParameters. Para obtener más información, consulta Sintaxis XAML propertyPath.

Uso de texto XAML

Los miembros del PropertyPath tipo no suelen establecerse en una sintaxis XAML directa. Vea la sección Comentarios.