Bajo la configuración de compilación estándar correspondiente a una aplicación de WPF que utiliza XAML, clases parciales y código subyacente, el x:Name especificado pasa a ser el nombre de un campo que se crea en el código subyacente al procesar el XAML mediante una tarea de compilación de marcado; este campo contiene una referencia al objeto. De manera predeterminada, el campo creado es interno.
Puede cambiar el acceso al campo especificando el atributo x:FieldModifier. En WPF y Silverlight, la secuencia consiste en que la compilación del marcado define y nombra el campo en una clase parcial, pero el valor está inicialmente vacío. A continuación, se llama a un método generado denominado InitializeComponent desde el constructor de clase.
InitializeComponent se compone de llamadas a FindName en las que se usan cada uno de los valores x:Name que existen en la parte definida por XAML de la clase parcial como cadenas de entrada. A continuación, los valores devueltos se asignan a la referencia de campo con el mismo nombre para rellenar los valores de campo con objetos creados a partir del análisis de XAML. La ejecución de InitializeComponent permite hacer referencia al gráfico de objetos en tiempo de ejecución usando el nombre del campo x:Name / directamente, en lugar de tener que llamar a FindName de forma explícita cada vez que se requiera una referencia a un objeto definido en XAML.
Para una aplicación WPF que usa destinos de Microsoft Visual Basic e incluye archivos XAML con una acción de compilación Page, se crea una propiedad de referencia independiente durante la compilación que agrega la palabra clave WithEvents a todos los elementos que tienen un atributo x:Name, a fin de admitir la sintaxis de Handles para los delegados de controladores de eventos.
Esta propiedad siempre es pública. Para obtener más información, consulte Control de eventos en Visual Basic y WPF.
Un procesador XAML de WPF usa x:Name para registrar un nombre en un ámbito de nombres XAML durante la carga, incluso en aquellos casos en que las acciones de compilación no compilan por marcado la página (por ejemplo, XAML separado de un diccionario de recursos).
Una de las causas de este comportamiento se debe a que x:Name se necesita potencialmente para el enlace de ElementName. Para obtener información detallada, vea Información general sobre el enlace de datos.
Tal y como se mencionó anteriormente, x:Name (o Name) no se deberían aplicar en situaciones que también utilizan x:Key.
El objeto WPF ResourceDictionary presenta un comportamiento especial que consiste en definirse a sí mismo como un ámbito de nombres XAML, pero devuelve Sin implementar o valores NULL para las API INameScope como una manera de imponer este comportamiento. Si el analizador XAML de WPF encuentra Name o x:Name en un elemento ResourceDictionary definido por XAML, el nombre no se agrega a ningún ámbito de nombres XAML. Al intentar encontrar ese nombre desde cualquier ámbito de nombres XAML y los métodos FindName no se devolverán resultados válidos.
x:Name y Name
Muchos escenarios de aplicación de WPF pueden evitar cualquier uso del atributo x:Name, porque la propiedad de dependencia Name, como se especifica dentro del espacio de nombres XAML predeterminado para varias de las clases base importantes como FrameworkElement y FrameworkContentElement, cumple este mismo propósito.
Todavía existen algunos escenarios de XAML y WPF comunes donde es importante tener acceso mediante código a un elemento que no tiene una propiedad Name en el nivel de marco. Por ejemplo, algunas clases de compatibilidad de animaciones y guiones gráficos no admiten una propiedad Name, pero con frecuencia debe hacerse referencia a estas en el código para controlar la animación. Debe especificar x:Name como atributo en las escalas de tiempo y transformaciones que se crean en XAML, si piensa hacer referencia a ellas desde el código más adelante.
Si Name está disponible como una propiedad de la clase, Name y x:Name se pueden usar de forma intercambiable como atributos, pero se producirá una excepción de análisis si ambas se especifican en el mismo elemento.
Si XAML es compilado de marcado, la excepción se producirá en la compilación de marcado, de lo contrario se produce en la carga.
Name
se puede establecer mediante la sintaxis de atributo XAML y también mediante código usando SetValue; no obstante, tenga en cuenta que, en la mayoría de las circunstancias, al establecer la propiedad Name en código no se crea la referencia de campo representativa dentro del ámbito de nombres XAML, donde XAML ya se ha cargado.
En lugar de intentar establecer Name mediante código, utilice los métodos NameScope del código, con respecto al ámbito de nombres correspondiente.
Name
también se puede establecer mediante la sintaxis de elementos de propiedad con texto interno, pero eso es raro.
En cambio, x:Name no se puede establecer en la sintaxis de elemento de propiedad de XAML, ni mediante código utilizando SetValue ; solo se puede establecer utilizando la sintaxis de atributo en objetos porque es una directiva.
