Compartilhar via

Diretiva x:Uid

  • Artigo

Fornece um identificador exclusivo para elementos de marcação. Em muitos cenários, esse identificador exclusivo é usado por ferramentas e processos de localização XAML.

Uso do atributo XAML

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

Valores XAML

Valor Descrição
identifier Uma cadeia de caracteres criada manualmente ou gerada automaticamente que deve ser exclusiva em um arquivo quando ela é interpretada por um consumidor x:Uid.

Observações

No [MS-XAML], x:Uid é definido como uma diretiva. Para obter mais informações, consulte [MS-XAML] Seção 7.3.6.

x:Uid é discreto de x:Name tanto devido ao cenário de localização XAML declarado quanto para que os identificadores usados para localização não tenham dependências das implicações do modelo de programação de x:Name. Além disso, x:Name é regido pelo namescope XAML; no entanto, x:Uid não é regido por nenhum conceito de imposição de exclusividade definido pela linguagem XAML. Os processadores XAML em um sentido amplo (processadores que não fazem parte do processo de localização) não devem impor a exclusividade de valores x:Uid. Essa responsabilidade está conceitualmente no originador dos valores. A expectativa de exclusividade de valores x:Uid em uma única fonte XAML é razoável para os consumidores dos valores, como processos ou ferramentas de globalização dedicados. O modelo de exclusividade típico é que x:Uid valores são exclusivos em um arquivo codificado em XML que representa XAML.

Ferramentas que têm conhecimento significativo de um esquema XAML específico podem optar por aplicar x:Uid somente para cadeias de caracteres localizáveis verdadeiras, em vez de para todos os casos em que um valor de cadeia de caracteres de texto é encontrado na marcação.

As estruturas podem especificar uma propriedade específica em seu modelo de objeto para ser um alias para x:Uid aplicando o atributo UidPropertyAttribute ao tipo de definição. Se uma estrutura especificar uma propriedade específica, não será válido especificar x:Uid e o membro alias no mesmo objeto. Se x:Uid e o membro aliased forem especificados, a API dos Serviços XAML do .NET normalmente gerará XamlDuplicateMemberException para esse caso.

Notas de uso do WPF

Para obter mais informações sobre a função de x:Uid no processo de localização do WPF e na forma BAML do XAML, consulte Globalization for WPF ou Uid

Consulte também