FrameworkContentElement.Name Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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

Name

Atributos

LocalizabilityAttribute

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

Confira também

• NameScope