FrameworkContentElement.Name FrameworkContentElement.Name FrameworkContentElement.Name FrameworkContentElement.Name Property

Definición

Obtiene o establece el nombre de identificación del elemento.Gets or sets the identifying name of the element. El nombre proporciona una referencia de instancia para que el código subyacente de programación, como el código del controlador de eventos, puede hacer referencia a un elemento una vez construido durante el análisis de XAMLXAML.The name provides an instance reference so that programmatic code-behind, such as event handler code, can refer to an element once it is constructed during parsing of XAMLXAML.

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; }
member this.Name : string with get, set
Public Property Name As String

Valor de propiedad

Nombre del elemento.The name of the element.

Implementaciones

Comentarios

El uso más común de esta propiedad es al especificar un XAMLXAML nombre de elemento de marcado.The most common usage of this property is when specifying a XAMLXAML element name in markup.

Básicamente, esta propiedad proporciona una propiedad de conveniencia de nivel de marco WPF para establecer el XAMLXAML x: Name Directive.This property essentially provides a WPF framework-level convenience property to set the XAMLXAML x:Name Directive.

Obtener un Name desde código no es común, porque si ya tiene la referencia adecuada en el código, simplemente puede llamar a métodos y propiedades en el elemento de referencia y por lo general no es necesario el Name.Getting a Name from code is not common, because if you have the appropriate reference in code already, you can just call methods and properties on the element reference and do not generally need the Name. Una excepción es si la cadena tiene algún significado sobrecargado, por ejemplo si es útil mostrar el nombre en IUUI.An exception is if the string has some overloaded meaning, for instance if it is useful to display that name in IUUI. Establecer un Name desde el código si la versión original Name era conjunto a partir de marcado no se recomienda también y cambiar la propiedad no cambiará la referencia de objeto.Setting a Name from code if the original Name was set from markup is also not recommended, and changing the property will not change the object reference. Estas referencias de objeto se crean solo cuando se crean explícitamente los ámbitos de nombres subyacentes durante XAMLXAML cargando.Such object references are created only when the underlying namescopes are explicitly created during XAMLXAML loading.

Debe llamar específicamente a RegisterName para realizar un cambio efectivo en el Name propiedad de un elemento ya cargado.You must specifically call RegisterName to make an effective change on the Name property of an already loaded element.

Un notables caso de que el valor Name desde el código es importante es para la nomenclatura de los elementos que guiones gráficos will ejecutan.One notable case where setting Name from code is important is for naming elements that storyboards will run against. Para poder registrar un nombre, también tendrá que crear una instancia y asignar un NameScope instancia.Before you can register a name, might also need to instantiate and assign a NameScope instance. Vea la sección de ejemplo o Storyboards Overview.See the Example section, or Storyboards Overview.

Establecer Name de código tiene aplicaciones limitadas, pero buscar un elemento por su nombre es más común, especialmente si se emplea un modelo de navegación donde se recargan las páginas en la aplicación y el código de tiempo de ejecución no es necesariamente el código subyacente de la que página correspondiente.Setting Name from code has limited applications, but looking up an element by name is more common, particularly if you are employing a navigation model where pages reload into the application and the run-time code is not necessarily the code-behind of that respective page. El método de utilidad FindName, que está disponible desde cualquier FrameworkContentElement, puede buscar cualquier elemento por Name de forma recursiva del árbol lógico de ese elemento.The utility method FindName, which is available from any FrameworkContentElement, can find any element by Name in that element's logical tree recursively. O bien puede usar el FindLogicalNode método estático de LogicalTreeHelper, que también toma la Name cadena como argumento.Or you can use the FindLogicalNode static method of LogicalTreeHelper, which also takes the Name string as an argument.

Elementos raíz de uso frecuente (Window, Page por ejemplo) implementan la interfaz INameScope.Commonly used root elements (Window, Page for example) implement the interface INameScope. Se esperan las implementaciones de esta interfaz para exigir que los nombres de ser inequívoco dentro de su ámbito.Implementations of this interface are expected to enforce that names be unambiguous within their scope.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field NameProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true IsAnimationProhibited

Se aplica a

Consulte también: