FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Propiedad

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

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

Boolean

true si los cambios en los valores de la subpropiedad no afectan a la representación si ha cambiado; de lo contrario, false. De manera predeterminada, es false.

Excepciones

InvalidOperationException

Los metadatos ya se aplicaron a una operación de propiedad de dependencia, por lo que están sellados y no se pueden establecer sus propiedades.

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 puede afectar al diseño, ya que comprobar todas las subpropiedades de los cambios es más lento que ejecutar realmente otro pase de representación. Establecer esta opción true en 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 PropertyMetadata normalmente se definen en el modelo de 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 consuman 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 se 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.

Consulte también

• Freezable