FrameworkContentElement.Name Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o nome identificativo do elemento. O nome fornece uma referência de instância para que o código programático por trás, como o código handler de eventos, possa referir-se a um elemento assim que este for construído durante a análise do XAML.
public:
property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public string Name { get; set; }[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.Name : string with get, setPublic Property Name As StringValor de Propriedade
O nome do elemento.
Implementações
- Atributos
Observações
A utilização mais comum desta propriedade é ao especificar o nome de um elemento XAML na marcação.
Esta propriedade fornece essencialmente uma WPF propriedade de conveniência ao nível do framework para definir a Diretiva XAML x:Nome.
Obter um Name código from não é comum, porque se já tiver a referência apropriada no código, pode simplesmente chamar métodos e propriedades na referência do elemento e geralmente não precisa do Name. Uma exceção é se a cadeia tiver algum significado sobrecarregado, por exemplo, se for útil mostrar esse nome na interface. Definir um Name código from se o original Name foi definido a partir de marcação também não é recomendado, e alterar a propriedade não altera a referência do objeto. Tais referências a objetos são criadas apenas quando os namescopes subjacentes são explicitamente criados durante o carregamento XAML.
Deve ligar RegisterName especificamente para fazer uma alteração eficaz na Name propriedade de um elemento já carregado.
Um caso notável em que o cenário Name a partir do código é importante é para nomear elementos contra os quais os storyboards vão correr. Antes de poderes registar um nome, talvez também precises de instanciar e atribuir uma NameScope instância. Veja a secção de Exemplos, ou Visão Geral dos Storyboards.
Definir Name a partir do código tem aplicações limitadas, mas procurar um elemento pelo nome é mais comum, especialmente se estiver a usar um modelo de navegação onde as páginas recarregam na aplicação e o código em tempo de execução não é necessariamente o código por trás dessa página respetiva. O método FindNamede utilidade , que está disponível a partir de qualquer FrameworkContentElement, pode encontrar qualquer elemento por Name na árvore lógica desse elemento recursivamente. Ou pode usar o FindLogicalNode método estático de LogicalTreeHelper, que também toma a Name cadeia como argumento.
Elementos raiz comumente usados (Windowpor Page exemplo) implementam a interface INameScope. As implementações desta interface devem garantir que os nomes sejam inequívocos dentro do seu âmbito.
Informação de Propriedade de Dependência
| Número | valor |
|---|---|
| Campo identificador | NameProperty |
Propriedades dos metadados definidas como true |
IsAnimationProhibited |