Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Propriedade FrameworkContentElement.Name

Obtém ou define o nome de identificação do elemento. O nome fornece uma referência de instância de forma que através de programação code-behind, como, por exemplo, o código de manipulador de eventos, pode se referir a um elemento depois que ela é construída durante a análise de XAML.

Namespace:  System.Windows
Assembly:  PresentationFramework (em PresentationFramework.dll)
XMLNS para XAML http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)]
public string Name { get; set; }
<object Name="string" .../>

Valor de propriedade

Tipo: System.String
O nome do elemento.

Implementações

IFrameworkInputElement.Name

Campo identificador

NameProperty

Propriedades de metadados definidas como true

IsAnimationProhibited

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

Essa propriedade fornece essencialmente um WPF framework-nível propriedade de conveniência para definir o XAMLDiretiva x:Name

Obtendo um Name do código não é comum, porque se você já a referência apropriada no código, você pode simplesmente chamar métodos e propriedades no elemento de referência e não geralmente necessidade de Name. Uma exceção é se a seqüência tem alguns sobrecarregado significando, por exemplo se ele é útil exibir esse nome na UI. Definindo um Name do código se o original Name foi o conjunto da marcação também não é recomendado e alterando a propriedade não alterará a referência de objeto. Tais referências de objeto são criadas somente quando os namescopes subjacentes são criados explicitamente durante XAML carregar.

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

Um notável caso onde a configuração Name do código é importante é para elementos de nomes que storyboards serão executadas. Antes de registrar um nome, talvez também precise criar uma instância e atribuir uma NameScope instância. Consulte a seção do exemplo, ou Visão geral de storyboards.

Definindo Name do código limitou os aplicativos, mas a pesquisa por nome de um elemento é mais comum, principalmente se você estiver empregando um modelo de navegação onde páginas Recarregar no aplicativo e o código de tempo de execução não é necessariamente code-behind da página respectivo. O método de utilitário FindName, que está disponível a partir de qualquer FrameworkContentElement, pode localizar qualquer elemento por Name no modo recursivo de árvore lógica desse elemento. Ou você pode usar o FindLogicalNode método estático da LogicalTreeHelper, que também leva a Name seqüência de caracteres como um argumento.

Normalmente usado elementos raiz (Window, Page por exemplo) implementa a interface INameScope. As implementações dessa interface deverão impor que nomes não podem ser ambíguos no seu escopo.

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft