Compartilhar via


Diretiva x:Uid

Fornece um identificador exclusivo para elementos de marcação. Em muitos cenários, esse identificador exclusivo é usado por processos e ferramentas 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 é interpretada por um x:Uid consumidor.

Comentários

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

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

As 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 definidor. Se uma estrutura especifica uma propriedade específica, não é válido especificar ambos x:Uid e o membro com alias no mesmo objeto. Se ambos x:Uid e o membro com alias forem especificados, a API de Serviços XAML do .NET normalmente será lançada XamlDuplicateMemberException para esse caso.

Notas de uso do WPF

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

Confira também