Diretiva x: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 do atributo XAML
<object x:Uid="stringID".../>
Valores XAML
| Termo | Descrição |
|---|---|
| ID da string | Uma cadeia de caracteres que identifica exclusivamente um elemento XAML em um aplicativo e se torna parte do caminho do recurso em um arquivo de recurso. Consulte Observações. |
Comentários
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 exibido em uma interface do usuário. A relação entre a cadeia de caracteres que você usa em x:Uid e as cadeias de caracteres que você usa 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 a ser substituído pelo texto de exibição Go, você deve especificar um novo recurso proveniente de um arquivo de recurso. Seu arquivo de recurso deve conter uma entrada para o recurso chamada "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 recurso para "GoButton.FlowDirection". Para obter mais informações sobre como usar x:Uid e arquivos de recurso juntos, consulte Localizar cadeias de caracteres na interface do usuário e no manifesto 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 de x:Uid é controlada pelo sistema PRI (índice de recursos de pacote). Para obter mais informações, consulte Sistema de Gerenciamento de Recursos.
O XAML UWP tem regras um pouco diferentes para exclusividade x:Uid do que as tecnologias anteriores de utilização de XAML usadas. Para XAML UWP, é 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ê usará um caminho de recurso em vez da funcionalidade interna do sistema PRI (índice de recursos do pacote). 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 é completado pelos nomes das propriedades especificadas em um arquivo de recursos ou que estão direcionando.
Não coloque x:Uid em elementos de propriedade, isso não é permitido no XAML do Tempo de Execução do Windows.