Compartir vía


FrameworkContentElement.Name Propiedad

Definición

Obtiene o establece el nombre de identificación del elemento. El nombre proporciona una referencia de instancia para que el código subyacente mediante programación, como el código del controlador de eventos, pueda hacer referencia a un elemento una vez que se construye durante el análisis 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 de propiedad

Nombre del elemento.

Implementaciones

Atributos

Comentarios

El uso más común de esta propiedad es al especificar un nombre de elemento XAML en el marcado.

Esta propiedad proporciona esencialmente una propiedad de conveniencia de nivel de marco de WPF para establecer la directiva XAML x:Name.

La obtención de un Name elemento a partir de código no es habitual, ya que si ya tiene la referencia adecuada en el código, puede llamar a métodos y propiedades en la referencia de elemento y, por lo general, no necesita .Name Una excepción es si la cadena tiene algún significado sobrecargado, por ejemplo, si es útil mostrar ese nombre en la interfaz de usuario. Establecer un Name valor a partir de código si el original Name se estableció a partir del marcado tampoco se recomienda y cambiar la propiedad no cambiará la referencia de objeto. Estas referencias de objeto solo se crean cuando los ámbitos de nombres subyacentes se crean explícitamente durante la carga de XAML.

Debe llamar RegisterName específicamente para realizar un cambio efectivo en la Name propiedad de un elemento ya cargado.

Un caso notable en el que la configuración Name del código es importante es asignar nombres a los elementos con los que se ejecutarán guiones gráficos. Para poder registrar un nombre, es posible que también tenga que crear instancias y asignar una NameScope instancia. Consulte la sección Ejemplo o Información general sobre guiones gráficos.

La configuración Name desde código tiene aplicaciones limitadas, pero buscar un elemento por nombre es más común, especialmente si usa un modelo de navegación en el que las páginas se vuelven a cargar en la aplicación y el código en tiempo de ejecución no es necesariamente el código subyacente de esa página respectiva. El método FindNamede utilidad , que está disponible desde cualquier FrameworkContentElement, puede encontrar cualquier elemento en Name el árbol lógico de ese elemento de forma recursiva. O bien, puede usar el FindLogicalNode método estático de LogicalTreeHelper, que también toma la Name cadena como argumento.

Los elementos raíz usados habitualmente (Windowpor Page ejemplo) implementan la interfaz INameScope. Se espera que las implementaciones de esta interfaz exijan que los nombres no sean ambiguos dentro de su ámbito.

Información sobre propiedades de dependencia

Campo identificador NameProperty
Propiedades de metadatos establecidas en true IsAnimationProhibited

Se aplica a

Consulte también