FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Propiedad

Definición

Obtiene o establece un valor que indica si las subpropiedades de la propiedad de dependencia no afectan a la representación del objeto contenedor.

public:
 property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };
public bool SubPropertiesDoNotAffectRender { get; set; }
member this.SubPropertiesDoNotAffectRender : bool with get, set
Public Property SubPropertiesDoNotAffectRender As Boolean

Valor de propiedad

true si los cambios en los valores de subpropualización no afectan a la representación si se cambian; de lo contrario, false. El valor predeterminado es false.

Excepciones

Los metadatos ya se han aplicado a una operación de propiedad de dependencia, de modo que no se puedan establecer los metadatos y las propiedades de los metadatos.

Comentarios

Esta opción de metadatos es pertinente para las propiedades de dependencia que son tipos de referencia, donde ese tipo tiene valores de propiedad propios. Normalmente, la lógica del sistema de diseño es suponer que cualquier propiedad de dependencia con subpropiedades podría afectar al diseño, ya que la comprobación de todas las subpropiedades de los cambios es más lenta que ejecutar realmente otro pase de representación. Establecer esta opción en true es útil para optimizar el rendimiento de la implementación del sistema de diseño de nivel de marco de WPF.

Las propiedades de las clases derivadas de normalmente se definen en el modelo de PropertyMetadata objetos como lectura y escritura. Esto es para que se puedan ajustar después de la inicialización de la instancia. Sin embargo, una vez que los metadatos se consumen como parte de una llamada a Register, AddOwnero OverrideMetadata, el sistema de propiedades sellará que la instancia de metadatos y las propiedades que transmiten los detalles de los metadatos ahora se consideran inmutables. Si intenta establecer esta propiedad después IsSealed de que se encuentra true en esta instancia de metadatos, se producirá una excepción.

Uso de texto XAML

Los miembros de esta clase no se suelen usar en XAML.

Se aplica a

Consulte también