Compartilhar via


Extensão de marcação x:Reference

Faz referência a uma instância declarada em outro lugar na marcação XAML. A referência refere-se ao x:Namede um elemento.

Uso do atributo XAML

<object property="{x:Reference instancexName}" .../>

Uso do elemento do objeto XAML

<object>
  <object.property>
    <x:Reference Name="instancexName"/>
  </object.property>
</object>

Valores XAML

Valor Descrição
instancexName O valor x:Name (ou o valor da propriedade RuntimeNamePropertyAttributeidentificada) da instância referenciada.

Observações

x:Reference fornece suporte em nível de linguagem XAML para um conceito de referência de elemento que, de outra forma, foi implementado em estruturas específicas, como o WPF.

x:Reference e WPF

No WPF e no XAML 2006, as referências de elemento são tratadas pelo recurso de nível de estrutura da associação de ElementName. Para a maioria dos aplicativos e cenários do WPF, ElementName associação ainda deve ser usada. Exceções a essa orientação geral podem incluir casos em que há contexto de dados ou outras considerações de escopo que tornam a associação de dados impraticável e onde a compilação de marcação não está envolvida.

x:Reference é um constructo definido no XAML 2009. No WPF, você pode usar recursos XAML 2009, mas apenas para XAML que não é compilado por marcação do WPF. O XAML compilado por marcação e a forma BAML de XAML atualmente não dão suporte às palavras-chave e recursos da linguagem XAML 2009.