Compartir a través de


Directiva x:Uid

Proporciona un identificador único para los elementos de marcado. Para Plataforma universal de Windows XAML (UWP), este identificador único lo usan los procesos y herramientas de localización XAML, como el uso de recursos de un archivo de recursos .resw.

Uso del atributo XAML

<object x:Uid="stringID".../>

Valores de XAML

Término Descripción
stringID Cadena que identifica de forma única un elemento XAML en una aplicación y se convierte en parte de la ruta de acceso del recurso en un archivo de recursos. Vea la sección Comentarios.

Comentarios

Usa x:Uid para identificar un elemento de objeto en tu XAML. Normalmente, este elemento de objeto es una instancia de una clase de control u otro elemento que se muestra en una interfaz de usuario. La relación entre la cadena que se usa en x:Uid y las cadenas que se usan en un archivo de recursos es que las cadenas del archivo de recursos son x :Uid seguidas de un punto (.) y, a continuación, por el nombre de una propiedad específica del elemento que se está localizando. Considere este ejemplo:

<Button x:Uid="GoButton" Content="Go"/>

Para especificar contenido para reemplazar el texto para mostrar Go, debe especificar un nuevo recurso procedente de un archivo de recursos. El archivo de recursos debe contener una entrada para el recurso denominado "GoButton.Content". El contenido en este caso es una propiedad específica heredada por la clase Button. También puede proporcionar valores localizados para otras propiedades de este botón, por ejemplo, podría proporcionar un valor basado en recursos para "GoButton.FlowDirection". Para obtener más información sobre cómo usar x:Uid y archivos de recursos juntos, consulta Localizar cadenas en el manifiesto de paquete de la aplicación y la interfaz de usuario.

La validez de las cadenas que se pueden usar para un valor x:Uid se controla en un sentido práctico mediante el cual las cadenas son legales como identificador en un archivo de recursos y una ruta de acceso de recurso.

x:Uid es discreto de x:Name , tanto debido al escenario de localización XAML indicado, como para que los identificadores que se usan para la localización no tengan dependencias en las implicaciones del modelo de programación de x:Name. Además, x:Name se rige por el concepto de ámbito de nombres XAML, mientras que la unicidad para x:Uid se controla mediante el sistema de índice de recursos del paquete (PRI). Para obtener más información, consulte Sistema de administración de recursos.

XAML para UWP tiene reglas algo diferentes para la unicidad x:Uid que las tecnologías de uso XAML anteriores usadas. Para XAML para UWP, es legal que el mismo valor de identificador x:Uid exista como directiva en varios elementos XAML. Sin embargo, cada elemento de este tipo debe compartir la misma lógica de resolución al resolver los recursos en un archivo de recursos. Además, todos los archivos XAML de un proyecto comparten un único ámbito de recurso con fines de resolución x:Uid , no hay ningún concepto de ámbitos x:Uid que se alinean con archivos XAML individuales.

En algunos casos, usará una ruta de acceso de recurso en lugar de una funcionalidad integrada del sistema de índice de recursos de paquete (PRI). Cualquier cadena usada como valor x:Uid define una ruta de acceso de recurso que comienza con ms-resource:///Resources/ e incluye la cadena x:Uid . La ruta de acceso se completa con los nombres de las propiedades que especifique en un archivo de recursos o, de lo contrario, el destino es .

No coloque x:Uid en elementos de propiedad, que no se permite en XAML de Windows Runtime.