PropertyPath.Path Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Obtiene o establece la cadena que describe la ruta de acceso.

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

String

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 del 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 de indexador (incluidos varios indexadores y diferenciación de tipos). Para obtener más información sobre la sintaxis de la cadena que 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 debe ser una propiedad de dependencia. Para obtener información, consulte Información general sobre enlace de datos.

Si se usa PropertyPath en 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 calificado de la cadena de nombre de propiedad de dependencia.

Si se PropertyPath usa para 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 reenviada 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 obtiene acceso a los elementos de las propiedades de la colección con una sintaxis del indexador, con el índice entre corchetes ([ y ]). El indexador es aditivo para el 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 se 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 guión gráfico de un solo paso, la PropertyPath(String, Object[]) firma de destinos de guion gráfico de varios pasos.

XAML: Cuando se usa para PropertyPath describir una referencia de propiedad en XAML, como un valor de atributo, la cadena que especifique 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 PropertyPath firmas del constructor. Este 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

Normalmente, los miembros del PropertyPath tipo no se establecen en una sintaxis XAML directa. Vea la sección Comentarios.