Partilhar via

x:Diretiva 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 de atributos 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 consumidor x:Uid.

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 é discreto de x:Name tanto por causa do cenário de localização XAML declarado quanto para que os identificadores usados para localização não tenham dependências nas implicações do modelo de programação de x:Name. Além disso, x:Name é governado pelo namescope XAML; no entanto, x:Uid não é regido por nenhum conceito definido pela linguagem XAML de imposição de exclusividade. Não se espera que os processadores XAML em sentido amplo (processadores que não fazem parte do processo de localização) imponham a exclusividade de x:Uid valores. Essa responsabilidade recai conceptualmente sobre o criador dos valores. A expectativa de exclusividade de valores x:Uid em uma única fonte XAML é razoável para os consumidores dos valores, como ferramentas ou processos de globalização dedicados. O modelo de exclusividade típico é que x:Uid valores são exclusivos dentro de um arquivo codificado em XML que representa XAML.

As ferramentas que têm conhecimento significativo de um esquema XAML específico podem optar por aplicar x:Uid apenas para cadeias de caracteres realizá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 x:Uid e o membro com alias no mesmo objeto. Se x:Uid e o membro com alias forem especificados, a API de Serviços XAML do .NET normalmente lançará XamlDuplicateMemberException para esse caso.

Notas de uso do WPF

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

Ver também