AmbientAttribute Clase
TOC
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

AmbientAttribute (Clase)

 

Especifica que una propiedad o un tipo debe tratarse como ambiente.El concepto ambiente está relacionado con la forma en que los procesadores XAML determinan los propietarios de tipos de los miembros.

Espacio de nombres:   System.Windows.Markup
Ensamblado:  System.Xaml (en System.Xaml.dll)

System.Object
  System.Attribute
    System.Windows.Markup.AmbientAttribute

[AttributeUsageAttribute(AttributeTargets.Class | AttributeTargets.Method | AttributeTargets.Property, 
	Inherited = true)]
public sealed class AmbientAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodAmbientAttribute()

Inicializa una nueva instancia de la clase AmbientAttribute.

NombreDescripción
System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute.)

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Heredado de Attribute.)

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute.)

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual. (Heredado de Object.)

System_CAPS_pubmethodIsDefaultAttribute()

Cuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada.(Heredado de Attribute.)

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute.)

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object.)

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute.)

Una propiedad de ambiente es una propiedad donde se espera que el valor esté disponible en el contexto del analizador al crear un gráfico de objetos, pero donde la búsqueda típica de miembro de tipo se suspende para la finalidad del conjunto de nodos XAML inmediato que se está creando.Hay dos escenarios principales para el concepto de ambiente:

  • Alguna otra propiedad del mismo objeto influye y califica cómo debería funcionar esa búsqueda de la propiedad de objeto.

  • La propiedad representa un mecanismo de aplazamiento mayor y las capacidades de ambiente para buscar un valor de miembro se extienden a todos los objetos contenidos dentro del objeto actual.

Este atributo se puede aplicar a las propiedades concretas que han esperado contenedores que habilitan un comportamiento de búsqueda de propiedad de ambiente o se puede aplicar a una clase para habilitar el comportamiento de propiedad de ambiente en todos los casos de ese tipo de valor para una propiedad.

AmbientAttribute también se puede aplicar a un método de CRL, para admitir el uso de atributos de una propiedad adjuntables de XAML como ambiente.Esto es potencialmente necesario porque en una implementación de CLR una propiedad adjunta de XAML se implementa/representa en la reflexión como un modelo de descriptor de acceso con los métodos get y set.No existe ninguna propiedad CLR para atribuirse, por tanto el uso restringido de AttributeTargets para Property no habría habilitado la especificación de un miembro asociable como ambiente.Para un miembro asociable que desee notificar como ambiente, atribuya el descriptor de acceso get.No debe intentar atribuir métodos que no son específicamente compatibles con miembros que se puedan asociar.

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

Los tipos de ambientes (tipos donde AmbientAttribute se aplica en el nivel de tipo) se pueden usar para ciertas situaciones del procesamiento XAML donde el tipo de una propiedad necesita ser resuelto fuera de orden.

Si está definiendo un sistema de escritura de objetos XAML, y encuentra una propiedad, método o tipo donde se aplica AmbientAttribute, debe tener acceso normalmente a un servicio para determinar el comportamiento previsto de búsqueda de propiedad de ambiente que se necesita para escribir objetos.Para obtener más información, vea IAmbientProvider.

Los convertidores de tipos o las extensiones de marcado podrían necesitar conocer la información de ambiente para procesar propiedades que representan asignaciones de tipo indirectas, como propiedades que especifican miembros o tipos por nombres de cadena con o sin calificación.En este escenario, AmbientAttribute no está pensado para usarse directamente para la lógica de código de convertidor de valores.Más bien, el convertidor de valores debería basarse en el comportamiento del sistema de escritura de XAML que pasará IAmbientProvider en sus contextos de servicio a sus métodos de convertidor de valores cuando se llaman.

  • Una propiedad de Style (TargetType) puede calificar las búsquedas de nombre de propiedad necesarias para encontrar las referencias de respaldo de las cadenas establecidas para nombres de propiedad en valores Setter.Property.

  • Todo el contenido de una propiedad Resources así como el contenido de la plantilla (elementos de un ResourceDictionary), deberían poder tener acceso a otros pares como valores.Declarar toda la propiedad Resources como ambiente invoca una lógica que habilita esto en el analizador XAML de WPF.

Vea ResourceDictionary para obtener un ejemplo de un escenario para establecer AmbientAttribute en el nivel de tipo.

.NET Framework
Disponible desde 3.0

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar:
© 2016 Microsoft