Partilhar via


FrameworkContentElement.Name Propriedade

Definição

Obtém ou define o nome de identificação do elemento. O nome fornece uma referência de instância para que o code-behind programático, como o código do manipulador de eventos, possa se referir a um elemento quando ele for construído durante a análise de 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, set
Public Property Name As String

Valor da propriedade

String

O nome do elemento.

Implementações

Atributos

Comentários

O uso mais comum dessa propriedade é ao especificar um nome de elemento XAML na marcação.

Essa propriedade fornece essencialmente uma propriedade de conveniência no nível da estrutura do WPF para definir a diretiva XAML x:Name.

A obtenção de um Name código de acesso não é comum, pois se você já tiver a referência apropriada no código, você pode chamar apenas métodos e propriedades na referência do elemento e geralmente não precisa do Name. Uma exceção será se a cadeia de caracteres tiver algum significado sobrecarregado, por exemplo, se for útil exibir esse nome na interface do usuário. Também não é recomendável definir um Name código a partir do código se o original Name foi definido da marcação e alterar a propriedade não alterará a referência do objeto. Essas referências de objeto são criadas somente quando os namescopes subjacentes são criados explicitamente durante o carregamento XAML.

Você deve chamar RegisterName especificamente para fazer uma alteração efetiva na Name propriedade de um elemento já carregado.

Um caso notável em que a configuração Name do código é importante é para nomear elementos nos quais os storyboards serão executados. Antes de registrar um nome, talvez também seja necessário criar uma instância e atribuir uma NameScope instância. Consulte a seção Exemplo ou Visão Geral de Storyboards.

A configuração Name do código tem aplicativos limitados, mas procurar um elemento por nome é mais comum, especialmente se você estiver empregando um modelo de navegação em que as páginas são recarregadas no aplicativo e o código em tempo de execução não é necessariamente o code-behind dessa respectiva página. O método FindNameutilitário, que está disponível de qualquer FrameworkContentElementum, pode encontrar qualquer elemento Name na árvore lógica desse elemento recursivamente. Ou você pode usar o FindLogicalNode método estático de LogicalTreeHelper, que também usa a Name cadeia de caracteres como um argumento.

Elementos raiz comumente usados (WindowPagepor exemplo) implementam a interfaceINameScope. Espera-se que as implementações dessa interface imponham que os nomes sejam inequívocas em seu escopo.

Informações da propriedade de dependência

Campo identificador NameProperty
Propriedades de metadados definidas como true IsAnimationProhibited

Aplica-se a

Confira também