FrameworkContentElement.Name Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property Name As StringValor da propriedade
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 essencialmente fornece 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 do código não é comum, pois se você já tiver a referência apropriada no código, poderá 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. Definir um Name código a partir do código se o original Name foi definido a partir da marcação também não é recomendado, e alterar a propriedade não alterará a referência de 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 com os 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 recarregam 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 em qualquer um FrameworkContentElement, 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 Dependency
| Item | Valor |
|---|---|
| Campo identificador | NameProperty |
Propriedades de metadados definidas como true |
IsAnimationProhibited |
