Espacios de nombres y asignación de espacios de nombres XAML para WPF

En este tema se explica con mayor detalle la presencia y el propósito de las dos asignaciones de espacio de nombres XAML que se encuentran a menudo en la etiqueta raíz de cada archivo XAML de WPF. También se describe cómo generar asignaciones similares para utilizar elementos definidos en su propio código y/o dentro de ensamblados independientes.

Este tema contiene las secciones siguientes.

• ¿Qué es un espacio de nombres XAML?
• Declaraciones de espacios de nombres en XAML y WPF
• Asignar a clases y ensamblados personalizados
• Asignar espacios de nombres CLR a espacios de nombres XML en un ensamblado
• Espacios de nombres de diseñador y otros prefijos de las plantillas XAML
• WPF y carga de ensamblados
• Temas relacionados

¿Qué es un espacio de nombres XAML?

Un espacio de nombres XAML es, realmente, una extensión del concepto de espacio de nombres XML. Las técnicas para especificar que un espacio de nombres XAML confían en la sintaxis del espacio de nombres XML, la convención de utilizar los URI como identificadores de los espacio de nombres, el uso de prefijos para proporcionar un medio para hacer referencia a varios espacios de nombres del mismo origen de marcado, etc. El concepto principal que se agrega a la definición XAML del espacio de nombres XML es que un espacio de nombres XAML implica un ámbito de singularidad para los usos de marcado y también influye en cómo las entidades de marcado están respaldadas potencialmente por espacios de nombres CLR y ensamblados concretos a los que se hace referencia. El concepto de un contexto de esquema XAML influye también en esta última consideración. Pero para el propósito de cómo trabaja WPF con espacios de nombres XAML, piense en los espacios de nombres XAML como en un espacio de nombres XAML predeterminado, el espacio de nombres del lenguaje XAML, y cualquier otro espacio de nombres XAML según lo asigna directamente el marcado XAML para respaldar espacios de nombres de CLR y ensamblados a los que se hace referencia específicos.

Declaraciones de espacios de nombres en XAML y WPF

Dentro de las declaraciones de espacios de nombres de la etiqueta raíz de muchos archivos XAML, observará que normalmente hay dos declaraciones de espacio de nombres XML. La primera declaración asigna el espacio de nombres cliente WPF / marco XAML global como predeterminado:

xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"

La segunda declaración asigna un espacio de nombres XAML independiente (normalmente) al prefijo x:.

xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"

La relación entre estas declaraciones es que la asignación del prefijo x: admite los elementos intrínsecos que forman parte de la definición del lenguaje XAML, y WPF es una implementación que utiliza XAML como lenguaje y define un vocabulario de sus objetos para XAML. Dado que los usos del vocabulario de WPF van a ser mucho más comunes que los usos de los elementos intrínsecos de XAML, el vocabulario de WPF se asigna como valor predeterminado.

La convención del prefijo x: para asignar los elementos intrínsecos del lenguaje XAML va seguida de las plantillas de proyecto, los ejemplos de código y la documentación de las características del lenguaje de este SDK. El espacio de nombres XAML define muchas de las características utilizadas normalmente que son necesarias incluso para las aplicaciones básicas de WPF. Por ejemplo, para combinar cualquier código subyacente con un archivo XAML a través de una clase parcial, debe denominar esa clase como el atributo x:Class del elemento raíz del archivo XAML pertinente. Por otra parte, cualquier elemento definido en una página XAML al que desee obtener acceso como recurso con clave debe tener el atributo x:Key establecido en el elemento en cuestión. Para obtener más información sobre éstos y otros aspectos de XAML, vea Información general sobre XAML (WPF) o Detalles de la sintaxis XAML.

Asignar a clases y ensamblados personalizados

Puede asignar espacios de nombres XML a ensamblados utilizando una serie de tokens dentro de una declaración de prefijo xmlns, de manera parecida al modo en que se asignan a prefijos los espacios de nombres XAML estándar de WPF y de los elementos intrínsecos de XAML.

La sintaxis acepta los siguientes tokens con nombre posibles y valores:

clr-namespace: espacio de nombres CLR declarado dentro del ensamblado que contiene los tipos públicos que se exponen como elementos.

assembly= El ensamblado que contiene la totalidad o parte del espacio de nombres CLR al que se hace referencia. Este valor suele ser simplemente el nombre del ensamblado, no la ruta de acceso, y no incluye la extensión (como .dll o .exe). La ruta de acceso a ese ensamblado se debe establecer como referencia de proyecto en el archivo de proyecto que contiene el XAML que se va a asignar. Para incorporar la administración de versiones y la firma de nombre seguro, el valor de assembly puede ser una cadena, de acuerdo con lo definido por AssemblyName, en lugar del nombre de cadena simple.

Observe que el carácter que separa el token clr-namespace de su valor es un signo de dos puntos (:), mientras que el carácter que separa el token assembly de su valor es un signo igual (=). El carácter que se utiliza entre estos dos tokens es un punto y coma. Tampoco debe incluir ningún espacio en blanco en ningún lugar de la declaración.

Ejemplo de asignación personalizada básica

En el siguiente código se define un ejemplo clase personalizada:

namespace SDKSample {
    public class ExampleClass : ContentControl {
        public ExampleClass() {
        ...
        }
    }
}

Namespace SDKSample
    Public Class ExampleClass
        Inherits ContentControl
         ...
        Public Sub New()
        End Sub
    End Class
End Namespace

A continuación, esta clase personalizada se compila en una biblioteca, que se denomina SDKSampleLibrary conforme a la configuración del proyecto (que no se muestra).

Para hacer referencia a esta clase personalizada, es preciso incluirla como referencia para su proyecto actual, lo que suele hacerse mediante la interfaz de usuario del Explorador de soluciones en Visual Studio.

Ahora que tiene una biblioteca que contiene una clase, y una referencia a ella en la configuración del proyecto, puede agregar la siguiente asignación de prefijo como parte del elemento raíz en XAML:

xmlns:custom="clr-namespace:SDKSample;assembly=SDKSampleLibrary"

Para combinarlo todo, el siguiente XAML incluye la asignación personalizada junto con las asignaciones predeterminadas y de x: en la etiqueta raíz. A continuación, utiliza una referencia con prefijo para crear una instancia de ExampleClass en esa interfaz de usuario:

<Page x:Class="WPFApplication1.MainPage"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:custom="clr-namespace:SDKSample;assembly=SDKSampleLibrary">
  ...
  <custom:ExampleClass/>
...
</Page>

Asignar a ensamblados actuales

Se pueden omitir assembly si el clr-namespace al que se hace referencia se define dentro del mismo ensamblado que el código de aplicación que hace referencia a las clases personalizadas. Otra sintaxis equivalente para este caso consiste en especificar assembly=, sin ningún token de cadena tras el signo igual.

Las clases personalizadas no se pueden utilizar como elemento raíz de una página si se definen en el mismo ensamblado. No es necesario asignar las clases parciales; únicamente es preciso asignar las clases que no son la clase parcial de una página de la aplicación si piensa hacer referencia a ellas como elementos en XAML.

Asignar espacios de nombres CLR a espacios de nombres XML en un ensamblado

WPF define un atributo CLR que utilizan los procesadores XAML para asignar varios espacios de nombres CLR a un mismo espacio de nombres XAML. Este atributo, XmlnsDefinitionAttribute, se coloca en el nivel de ensamblado en el código fuente que genera el ensamblado. El código fuente del ensamblado WPF utiliza este atributo para asignar los distintos espacios de nombres comunes, como System.Windows y System.Windows.Controls, al espacio de nombres https://schemas.microsoft.com/winfx/2006/xaml/presentation.

XmlnsDefinitionAttribute toma dos parámetros: el nombre del espacio de nombres XML/XAML y el nombre del espacio de nombres CLR. Puede haber más de un XmlnsDefinitionAttribute para asignar varios espacios de nombres CLR al mismo espacio de nombres XML. Una vez asignados, si se desea se puede hacer referencia también a los miembros de esos espacios de nombres aunque no estén completos, proporcionando la instrucción using adecuada en la página de código subyacente de la clase parcial. Para obtener más detalles, vea XmlnsDefinitionAttribute.

Espacios de nombres de diseñador y otros prefijos de las plantillas XAML

Si trabaja con entornos de desarrollo y/o herramientas de diseño para XAML de WPF, tal vez observe que hay otros espacios de nombres XAML / prefijos definidos dentro del marcado XAML.

WPF Designer for Visual Studio utiliza un espacio de nombres de diseñador que está asignado normalmente al prefijo d:. Las plantillas de proyecto de WPF más recientes podrían pre-asignar este espacio de nombres XAML para admitir el intercambio de XAML entre WPF Designer for Visual Studio y otros entornos de diseño. Este espacio de nombres XAML de diseño se utiliza para perpetuar el estado del diseño mientras la interfaz de usuario basada en XAML en el diseñador va y vuelve. También lo utilizan características como d:IsDataSource, que habilitan los orígenes de datos en tiempo de ejecución en un diseñador.

Otro prefijo que podría ver asignado es mc:. mc: es para ofrecer compatibilidad de marcado, y aprovecha un modelo de compatibilidad de marcado que no es específico de XAML. Hasta cierto punto, las características de compatibilidad de marcado se pueden utilizar para intercambiar XAML entre marcos o entre otros límites de implementación de respaldo, trabajar entre contextos de esquema XAML, ofrecer compatibilidad para modos limitados en los diseñadores, etc. Para obtener más información sobre los conceptos de compatibilidad de marcado y su relación con WPF, vea Características del lenguaje de compatibilidad de marcado (mc:).

WPF y carga de ensamblados

El contexto de esquema XAML para WPF se integra con el modelo de aplicaciones de WPF que, a su vez, utiliza el concepto de AppDomain definido por CLR. La siguiente secuencia describe cómo el contexto de esquema XAML interpreta cómo cargar ensamblados o buscar tipos en tiempo de ejecución o en tiempo de diseño, basándose en el uso de AppDomain por parte de WPF y otros factores.

1. Recorra en iteración AppDomain, buscando un ensamblado ya cargado que coincida con todos los aspectos del nombre, empezando por el ensamblado cargado más recientemente.

2. Si el nombre es completo, llame a Assembly.Load(String) por su nombre completo.

3. Si el nombre corto + el token de clave pública de un nombre completo coinciden con el ensamblado desde el que se cargó el marcado, devuelva dicho ensamblado.

4. Utilice el nombre corto + el token de clave pública para llamar a Assembly.Load(String).

5. Si el nombre es incompleto, llame a Assembly.LoadWithPartialName.

El XAML dinámico no utiliza el Paso 3; no hay ensamblado desde el que cargar.

El XAML compilado para WPF (generado mediante XamlBuildTask) no utiliza los ensamblados ya cargados desde AppDomain (Paso 1). Además, el nombre nunca debe estar incompleto en la salida de XamlBuildTask, por lo que el Paso 5 no se aplica.

El BAML compilado (generado mediante PresentationBuildTask) utiliza todos los pasos, aunque el BAML tampoco debe contener nombres de ensamblado incompletos.

Vea también

Conceptos

Información general sobre XAML (WPF)

Otros recursos

Understanding XML Namespaces

Historial de cambios