Diretiva x:Uidx:Uid directive

Fornece um identificador exclusivo para elementos de marcação.Provides a unique identifier for markup elements. Para o XAML da UWP (Plataforma Universal do Windows), este identificador exclusivo é usado por processos e ferramentas de localização XAML, como o uso de recursos de um arquivo de recursos .resw.For Universal Windows Platform (UWP) XAML, this unique identifier is used by XAML localization processes and tools, such as using resources from a .resw resource file.

Uso do atributo XAMLXAML attribute usage

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

Valores XAMLXAML values

TermoTerm DescriçãoDescription
stringIDstringID Uma cadeia de caracteres que identifica um elemento XAML em um aplicativo e torna-se parte do caminho do recurso em um arquivo de recurso.A string that uniquely identifies a XAML element in an app, and becomes part of the resource path in a resource file. Veja os comentários.See Remarks.  

ComentáriosRemarks

Use x:Uid para identificar um elemento de objeto em seu XAML.Use x:Uid to identify an object element in your XAML. Normalmente, esse elemento de objeto é uma instância de uma classe de controle ou outro elemento exibido em uma interface do usuário.Typically this object element is an instance of a control class or other element that is displayed in a UI. 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 o X:UID seguido por um ponto (.) e, em seguida, pelo nome de uma propriedade específica do elemento que está sendo localizada.The relationship between the string you use in x:Uid and the strings you use in a resources file is that the resource file strings are the x:Uid followed by a dot (.) and then by the name of a specific property of the element that's being localized. Considere este exemplo:Consider this example:

<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 proveniente de um arquivo de recursos.To specify content to replace the display text Go, you must specify a new resource that comes from a resource file. O arquivo de recursos deve conter uma entrada para o recurso nomeado "GoButton.Content".Your resource file should contain an entry for the resource named "GoButton.Content". Conteúdo nesse caso é uma propriedade específica que é herdada pela botão classe.Content in this case is a specific property that's inherited by the Button class. Você também pode fornecer valores localizados para outras propriedades desse botão, por exemplo, um valor baseado em recursos para "GoButton.FlowDirection".You might also provide localized values for other properties of this button, for example you could provide a resource-based value for "GoButton.FlowDirection". Para obter mais informações sobre como usar x:Uid e os arquivos de recursos juntos, consulte Localizar cadeias de caracteres na interface do usuário e no manifesto do pacote do aplicativo.For more info on how to use x:Uid and resource files together, see Localize strings in your UI and app package manifest.

A validade de quais cadeias de caracteres podem ser usadas para um valor x:Uid é controlada de maneira prática, por meio da qual as cadeias de caracteres são legais enquanto identificadores em um arquivo de recursos e um caminho de recurso.The validity of which strings can be used for an x:Uid value is controlled in a practical sense by which strings are legal as an identifier in a resource file and a resource path.

x:Uid é separado de x:Name em função do cenário de localização de XAML declarado, de tal forma que os identificadores usados para localização não têm dependências nas implicações do modelo de programação de x:Name.x:Uid is discrete from x:Name both because of the stated XAML localization scenario, and so that identifiers that are used for localization have no dependencies on the programming model implications of x:Name. Além disso, x:Name é controlado pelo conceito de namescope XAML, enquanto a exclusividade para x:Uid é controlada pelo sistema PRI (índice de recursos de pacote).Also, x:Name is governed by the XAML namescope concept, whereas uniqueness for x:Uid is controlled by the package resource index (PRI) system. Para saber mais, veja Sistema de Gerenciamento de Recursos.For more info, see Resource Management System.

A linguagem XAML da UWP tem regras um pouco diferentes de exclusividade x:Uid em relação às tecnologias anteriores que usam XAML.UWP XAML has somewhat different rules for x:Uid uniqueness than previous XAML-utilizing technologies used. Para a linguagem XAML da UWP, a existência do mesmo valor de ID x:Uid como diretiva em vários elementos XAML é legal.For UWP XAML it is legal for the same x:Uid ID value to exist as a directive on multiple XAML elements. Entretanto, cada elemento deve compartilhar a mesma lógica de resolução ao resolver os recursos em um arquivo de recursos.However, each such element must then share the same resolution logic when resolving the resources in a resource file. Além disso, todos os arquivos XAML em um projeto compartilham um único escopo de recurso para fins de resolução de x:Uid. Não há um conceito de alinhamento de escopos de x:Uid em arquivos XAML individuais.Also, all XAML files in a project share a single resource scope for purposes of x:Uid resolution, there is no concept of x:Uid scopes being aligned to individual XAML files.

Em alguns casos, você usará um caminho de recurso, em vez de funcionalidade interna do sistema PRI (índice de recursos de pacote).In some cases you'll be using a resource path rather than built-in functionality of the package resource index (PRI) system. 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.Any string used as an x:Uid value defines a resource path that begins with ms-resource:///Resources/ and includes the x:Uid string. O caminho é completado pelos nomes das propriedades que você especifica em um arquivo de recursos ou de outro modo está direcionando.The path is completed by the names of the properties you specify in a resources file or are otherwise targeting.

Não coloque x:Uid em elementos de propriedade, o que não é permitido no XAML do Windows Runtime.Don't put x:Uid on property elements, that isn't allowed in Windows Runtime XAML.