Compartir a través de


Elemento de directiva x:Code de XAML

Actualización: noviembre 2007

Permite colocar código dentro de una página XAML, para su compilación por cualquier implementación de procesador XAML que compile XAML, en lugar de interpretarlo.

Uso de elementos de objeto XAML

<object>
<x:Code>
   // code instructions, usually enclosed by CDATA...
</x:Code>
</object>

Dependencias

Atributo x:Class también se debe proporcionar en el elemento primario mostrado como object en la sintaxis, y ese elemento debe ser el elemento raíz de una página. El elemento de directiva x:Code debe ser un elemento secundario inmediato del elemento raíz object.

Comentarios

El código incluido en el elemento de directiva x:Code de XAML se interpreta dentro de los espacios de nombres XML proporcionados. Por consiguiente, suele ser necesario incluir también el código de x:Code dentro de un segmento CDATA.

x:Code no se permite para todos los mecanismos de implementación posibles de un archivo XAML. El código para WPF se tiene que compilar, no se interpreta ni utiliza según el principio Just-In-Time (JIT). Por ejemplo, x:Code no se permite dentro de ningún documento XML Paper Specification (XPS), ni en XAML dinámico.

Los valores y destinos del proyecto contenedor que se utiliza para compilar la aplicación determinan el compilador del lenguaje correcto que se debe utilizar para el contenido de x:Code.

El código declarado dentro de x:Code tiene varias limitaciones notables. La compilación tratará el código colocado dentro de x:Code como si estuviera dentro del ámbito de la clase parcial que ya se está creando para esa página XAML. Por consiguiente, todo el código que se defina deberá estar constituido por miembros o variables de esa clase parcial. No se pueden definir clases adicionales, excepto mediante anidación de una clase dentro de la clase parcial (aunque es válido, no suele hacerse, porque en XAML no se puede hacer referencia a las clases anidadas). No se pueden definir ni agregar otros espacios de nombres CLR, excepto el espacio de nombres utilizado para la clase parcial existente. Las referencias a entidades de código que se encuentren fuera del espacio de nombres CLR de la clase parcial deben ser siempre completas. Si los miembros que se declaran son invalidaciones de miembros invalidables de la clase parcial, esto se debe especificar mediante la palabra clave de invalidación específica del lenguaje. Si existen miembros que están en conflicto con miembros de la clase parcial creados fuera de la página XAML, de tal forma que el compilador lo notifica, el archivo XAML no se cargará ni compilará.

Vea también

Conceptos

Código subyacente y XAML

Información general sobre XAML

Referencia

Atributo x:Class