x:Uid (Directiva)

  • Artículo

Proporciona un identificador único para los elementos de marcado. En muchos escenarios los procesos y herramientas de localización XAML usan este identificador único.

Uso de atributos XAML

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

Valores XAML

Value Descripción
identifier Una cadena creada manualmente o generada automáticamente que debe ser única en un archivo cuando lo interpreta un consumidor de x:Uid.

Comentarios

En [MS-XAML] x:Uid se define como una directiva. Para obtener más información, vea [MS-XAML] Sección 7.3.6.

x:Uid es independiente de x:Name por el escenario de localización de XAML establecido y porque, por esta razón, los identificadores que se usan para la localización no tienen dependencias en las implicaciones del modelo de programación de x:Name. Además, x:Name se rige por el ámbito de nombres XAML; sin embargo, x:Uid no se rige por ningún concepto definido por el lenguaje XAML de aplicación de unicidad. No se espera que los procesadores XAML, en un sentido amplio (procesadores que no forman parte del proceso de localización), apliquen la unicidad de los valores de x:Uid. Esa responsabilidad se basa conceptualmente en el originador de los valores. La expectativa de unicidad de valores de x:Uid dentro de un único origen XAML es razonable para los consumidores de los valores, tal como procesos o herramientas de globalización dedicados. El modelo de unicidad típico es que los valores de x:Uid son únicos dentro de un archivo codificado en XML que representa XAML.

Las herramientas que tienen un conocimiento significativo de un esquema XAML determinado pueden optar por aplicar x:Uid solo para cadenas verdaderamente localizables, en lugar de para todos los casos en los que se encuentra un valor de cadena de texto en el marcado.

Los marcos de trabajo pueden especificar una propiedad determinada en su modelo de objetos para ser un alias para x:Uid mediante la aplicación del UidPropertyAttribute de atributo al tipo de definición. Si un marco de trabajo especifica una propiedad determinada, no es válido especificar x:Uid y el miembro con alias en el mismo objeto. Si se especifican x:Uid y el miembro con alias, normalmente la API de servicios XAML de .NET iniciará XamlDuplicateMemberException para este caso.

Notas de uso de WPF

Para obtener más información sobre el rol de x:Uid en el proceso de localización de WPF y en el formato BAML de XAML, consulte Globalización para WPF o Uid

Vea también