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.Gets or sets a value that indicates whether sub-properties of the dependency property do not affect the rendering of the containing object.

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 la subpropiedad no afectan a la representación si ha cambiado; de lo contrario, false.true if changes to sub-property values do not affect rendering if changed; otherwise, false. De manera predeterminada, es false.The default is false.

Excepciones

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.The metadata has already been applied to a dependency property operation, so that metadata is sealed and properties of the metadata cannot be set.

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.This metadata option is pertinent for dependency properties that are reference types, where that type has property values of its own. Normalmente, la lógica del sistema de diseño consiste en suponer que cualquier propiedad de dependencia con subpropiedades puede afectar al diseño, ya que la comprobación de todas las subpropiedades de los cambios es más lenta que la ejecución de otra fase de representación.Typically, the layout system logic is to assume that any dependency property with sub-properties potentially will affect layout, because checking all sub-properties for changes is more time consuming than actually running another render pass. 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.Setting this option to true is useful for optimizing performance of the WPF framework level layout system implementation.

Las propiedades de las clases PropertyMetadata derivadas de se definen normalmente en el modelo de objetos como de lectura y escritura.Properties on derived classes of PropertyMetadata are typically defined in the object model as read-write. Esto es para que se puedan ajustar después de la inicialización de la instancia.This is so they can be adjusted after initialization of the instance. Sin embargo, una vez que los metadatos se consuman Registercomo AddOwnerparte de OverrideMetadatauna llamada a, o, el sistema de propiedades sellará esa instancia de metadatos y las propiedades que transmiten los detalles de los metadatos se consideran ahora inmutables.However, once the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and properties that convey the specifics of the metadata are now considered immutable. Si se IsSealed true intenta establecer esta propiedad después de en esta instancia de metadatos, se producirá una excepción.Attempting to set this property after IsSealed is true on this metadata instance will raise an exception.

Uso de texto XAMLXAML Text Usage

Los miembros de esta clase no se utilizan normalmente XAMLXAMLen.Members of this class are not typically used in XAMLXAML.

Se aplica a

Consulte también: