x:Diretiva Uid

Fornece um identificador exclusivo para elementos de marcação. Para XAML da Plataforma Universal do Windows (UWP), esse identificador exclusivo é usado por processos e ferramentas de localização XAML, como o uso de recursos de um arquivo de recurso .resw.

Uso de atributos XAML

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

Valores XAML

Observações

Use x:Uid para identificar um elemento de objeto em seu XAML. Normalmente, esse elemento de objeto é uma instância de uma classe de controle ou outro elemento que é exibido em uma interface do usuário. A relação entre a cadeia de caracteres usada em x:Uid e as cadeias de caracteres usadas em um arquivo de recursos é que as cadeias de caracteres do arquivo de recurso são x :Uid seguidas por um ponto (.) e, em seguida, pelo nome de uma propriedade específica do elemento que está sendo localizado. Considere este exemplo:

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

Para especificar o conteúdo para substituir o texto de exibição Go, você deve especificar um novo recurso que vem de um arquivo de recurso. Seu arquivo de recurso deve conter uma entrada para o recurso chamado "GoButton.Content". O conteúdo , nesse caso, é uma propriedade específica herdada pela classe Button . Você também pode fornecer valores localizados para outras propriedades desse botão, por exemplo, você pode fornecer um valor baseado em recursos para "GoButton.FlowDirection". Para saber mais sobre como usar x:Uid e arquivos de recursos juntos, veja Localizar cadeias de caracteres no manifesto da interface do usuário e do pacote do aplicativo.

A validade de quais cadeias de caracteres podem ser usadas para um valor x:Uid é controlada em um sentido prático pelo qual as cadeias de caracteres são legais como um identificador em um arquivo de recurso e um caminho de recurso.

x:Uid é discreto de x:Name devido ao cenário de localização XAML declarado e 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 é regido pelo conceito de namescope XAML, enquanto a exclusividade para x:Uid é controlada pelo sistema de índice de recursos de pacote (PRI). Para obter mais informações, consulte Gerenciar recursos com o MRT Core e o Resource Management System.

O XAML do Windows Runtime tem regras um pouco diferentes para a unicidade de x:Uid em comparação com as tecnologias anteriores que utilizavam XAML. Para XAML do Window Runtime, é legal que o mesmo valor de ID x:Uid exista como uma diretiva em vários elementos XAML. No entanto, cada um desses elementos deve compartilhar a mesma lógica de resolução ao resolver os recursos em um arquivo de recurso. Além disso, todos os arquivos XAML em um projeto compartilham um único escopo de recurso para fins de resolução x:Uid , não há nenhum conceito de escopos x:Uid sendo alinhados a arquivos XAML individuais.

Em alguns casos, você estará usando um caminho de recurso em vez da funcionalidade interna do sistema de índice de recursos de pacote (PRI). Qualquer cadeia de caracteres usada como um valor x:Uid define um caminho de recurso que começa com ms-resource:///Resources/ e inclui a cadeia de caracteres x:Uid . O caminho é concluído pelos nomes das propriedades que especificar num ficheiro de recursos ou que estiver a direcionar.

Não coloque x:Uid em elementos de propriedade, isso não é permitido no XAML do Tempo de Execução do Windows.