XmlnsPrefixAttribute Clase

Definición

public ref class XmlnsPrefixAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type XmlnsPrefixAttribute = class
    inherit Attribute

Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute

Herencia

Object

Attribute

XmlnsPrefixAttribute

Atributos

AttributeUsageAttribute

Comentarios

Los procesadores o marcos XAML que incorporan XAML o cualquier proceso que realice la serialización XAML suelen respetar el prefijo recomendado. El prefijo puede ser necesario en cualquier caso en el que los prefijos de asignaciones específicas del origen XAML original no se conservan de alguna manera en el gráfico de objetos en tiempo de ejecución o almacenados por un marco o tecnología. Un marco de trabajo podría tener preferencias específicas sobre cómo serializar sus propios tipos que omiten el prefijo recomendado de sus propios ensamblados; Esto puede hacerse para promover de forma coherente un espacio de nombres XAML predeterminado. Sin embargo, este marco debe seguir proporcionando prefijos recomendados para posibles usos de herramientas y de terceros de sus tipos XAML. Consulta la sección "Procedimiento recomendado para la compatibilidad con el diseñador XAML o la serialización general" a continuación.

Una recomendación general para los prefijos es usar cadenas cortas, ya que el prefijo normalmente se aplica a todos los elementos serializados que proceden del espacio de nombres XAML. La longitud de la cadena de prefijo puede tener un efecto notable en el tamaño de la salida XAML serializada.

Si otro identificador de espacio de nombres XAML encontrado o serializado ya usa un prefijo que se solicita, el comportamiento no se especifica (el comportamiento es hasta cada implementación de procesador XAML individual).

En la mayoría de los casos, solo se aplica XmlnsPrefixAttribute si también se ha aplicado al menos uno XmlnsDefinitionAttribute en el ensamblado para ese mismo espacio de nombres XAML.

En versiones anteriores de .NET Framework, esta clase existía en el ensamblado específico de WPF WindowsBase. En .NET Framework 4, XmlnsPrefixAttribute está en el ensamblado System.Xaml. Para obtener más información, vea Tipos migrados de WPF a System.Xaml.

Procedimiento recomendado para la compatibilidad con el diseñador XAML o la serialización general

Incluso si piensas que el espacio de nombres XAML asociado sea el espacio de nombres XAML predeterminado en la mayoría de los casos de uso de tu marco o biblioteca, sigues especificando una cadena no vacía como prefijo recomendado para un espacio de nombres XAML. La información predeterminada del espacio de nombres XAML se lleva a cabo en archivos XAML individuales y flujos de nodos XAML. El espacio de nombres XAML predeterminado y cómo se define en un origen XAML determinado se puede perpetuar fácilmente para la serialización por caso sin usar XmlnsPrefixAttribute. Sin embargo, XmlnsPrefixAttribute resulta útil para los casos en los que el autor xaml ha elegido asignar el espacio de nombres XAML predeterminado a otra cosa. En este escenario, un editor de texto XAML incrustado en un entorno de diseño puede usar XmlnsPrefixAttribute como sugerencia para una asignación inicial de espacio xmlns de nombres XAML. O bien, un entorno de diseño puede agregar asignaciones Just-In-Time al XAML de respaldo para metáforas de diseño, como arrastrar objetos fuera de un cuadro de herramientas y a una superficie de diseño visual. Además, es posible que un diseñador admita simultáneamente varios marcos de habilitación de XAML y tenga un serializador XAML común que se basa en servicios XAML de .NET Framework en lugar de serialización específica del marco. Especificar para XmlnsPrefixAttribute estos escenarios ayuda a hacer que el uso de XAML para los tipos sea más portátil y sólido si el XAML se intercambia entre herramientas de diseño o se somete a un recorrido de ida y vuelta entre los editores XAML y otros consumidores, como compiladores de marcado u otra serialización.

Consulte también

• Atributos CLR relacionados con XAML para tipos y bibliotecas personalizados
• tipos personalizados Define para usarlos con servicios XAML de .NET
• Servicios XAML