AmbientPropertyValue Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Informa sobre una propiedad de ambiente durante el proceso de implementación de IAmbientProvider.
public ref class AmbientPropertyValuepublic class AmbientPropertyValuetype AmbientPropertyValue = classPublic Class AmbientPropertyValue- Herencia
-
AmbientPropertyValue
Comentarios
AmbientPropertyValue representa un elemento de información que se devuelve mediante una llamada a un IAmbientProvider método de servicio. Los GetAll métodos devuelven enumeraciones o matrices de AmbientPropertyValue elementos; los GetFirst métodos devuelven un único AmbientPropertyValue.
Acerca de las propiedades ambientales
Una propiedad ambiente es una propiedad cuyo valor de propiedad debe estar disponible para el uso del convertidor de valores en la estructura del nodo XAML y en el gráfico de objetos debajo de ella. El concepto ambiente es relevante para un procesador XAML durante la fase de escritura de objetos de la ruta de acceso de carga o la fase de serialización de una ruta de acceso de guardado.
Un tipo también se puede atribuir como ambiente. En este caso, todas las propiedades que usan el tipo con atributos se notifican como ambiente.
En el caso de la ruta de acceso de carga, el valor de la propiedad ambiente podría influir en el gráfico de objetos generado por otras propiedades que existen debajo de ella en una estructura de nodo XAML. Cuando se procesa como un flujo de nodo XAML, el concepto ambiente implica que el valor de la propiedad ambiente debe estar disponible para convertidores de tipos y extensiones de marcado de StartObject a EndObject. Del mismo modo, un convertidor de tipos o una extensión de marcado que se usa para la ruta de acceso de guardado puede buscar la propiedad ambiente y su valor. Por lo tanto, el XAML que se genera es una mejor representación de ida y vuelta.
Por su definición de lenguaje, XAML no especifica el orden en el que se deben procesar los miembros de un objeto. Sin embargo, el lector XAML debe procesar primero cualquier valor de propiedad ambiente para que el convertidor de tipos y el uso de la extensión de marcado contenidos en otras propiedades puedan acceder a él a través del IAmbientProvider servicio.
DependsOn es un concepto similar que también influye en el orden de procesamiento de nodos XAML. Sin embargo, DependsOn solo se puede usar para las relaciones de miembro del mismo nivel y nodo; no puede influir en todos los descendientes. Además, DependsOn influye directamente en la configuración de la propiedad del grafo de objetos, mientras que la técnica ambiental se basa en convertidores de tipos o extensiones de marcado. En la técnica ambiental, también debe haber un convertidor de tipos específico o una definición de extensión de marcado. Es hasta cada convertidor de tipos o extensión de marcado para determinar cómo se debe interpretar y aplicar el valor de la propiedad ambiente a la ubicación del gráfico de objetos donde se usa el convertidor de tipos o la extensión de marcado.
Notas de uso de WPF
Un escenario de propiedad ambiente que se muestra en el conjunto de características de WPF es Style.TargetType, que puede calificar las búsquedas de nombres de propiedad necesarias para otros valores. En este caso, el Style.TargetType valor califica los Setter.Property valores de los nodos XAML debajo de él. Setter.Propertyusa el comportamiento del convertidor de tipos para .DependencyProperty Este comportamiento accede al valor ambiente Style.TargetType consultando GetFirstAmbientValue desde un contexto de servicio que está disponible para convertidores de tipos y extensiones de marcado.
Constructores
| AmbientPropertyValue(XamlMember, Object) |
Inicializa una nueva instancia de la clase AmbientPropertyValue. |
Propiedades
| RetrievedProperty |
Obtiene el identificador del sistema de tipos XAML (XamlMember) que representa la propiedad de ambiente. |
| Value |
Obtiene el valor de la propiedad de ambiente. |
Métodos
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
