RenderOptions.CacheInvalidationThresholdMinimum Proprietà associata

Definizione

Ottiene o imposta il valore minimo di soglia della mancata convalida della cache per un oggetto DependencyObject specificato.Gets or sets the cache invalidation threshold minimum value for a given DependencyObject.

see GetCacheInvalidationThresholdMinimum, and SetCacheInvalidationThresholdMinimum
see GetCacheInvalidationThresholdMinimum, and SetCacheInvalidationThresholdMinimum
see GetCacheInvalidationThresholdMinimum, and SetCacheInvalidationThresholdMinimum

Esempio

Nell'esempio seguente viene illustrato come utilizzare l'opzione di hint per la memorizzazione nella cache per un DrawingBrush.The following example shows how to use the caching hint option for a DrawingBrush.

<DrawingBrush x:Key="drawingBrush"
              RenderOptions.CachingHint="Cache"
              RenderOptions.CacheInvalidationThresholdMaximum="2.0"
              RenderOptions.CacheInvalidationThresholdMinimum="0.5">
    <DrawingBrush.Drawing>
        <GeometryDrawing Brush="Blue">
            <GeometryDrawing.Geometry>
                <GeometryGroup>
                    <EllipseGeometry RadiusX="20" RadiusY="20" Center="10,10" />
                </GeometryGroup>
            </GeometryDrawing.Geometry>
            <GeometryDrawing.Pen>
                <Pen Thickness="10" Brush="Black" />
            </GeometryDrawing.Pen>
        </GeometryDrawing>
    </DrawingBrush.Drawing>
</DrawingBrush>

Commenti

Questa proprietà associata è supportata da TileBrush e dai relativi tipi derivati.This attached property is supported by TileBrush and its derived types. Deve essere usato con pennelli con superfici intermedie, ad esempio DrawingBrush e VisualBrush.It is intended to be used with brushes that have intermediate surfaces, such as DrawingBrush and VisualBrush. Ha effetto solo quando la proprietà CachingHint è impostata su Cache.It only has an effect when the CachingHint property is set to Cache.

Per impostazione predefinita, WPFWPF non memorizza nella cache il contenuto sottoposto a rendering degli oggetti DrawingBrush e VisualBrush.By default, WPFWPF does not cache the rendered contents of DrawingBrush and VisualBrush objects. Negli scenari statici, in cui non viene modificato né il contenuto né l'uso del pennello nella scena, la memorizzazione nella cache del contenuto fornisce un vantaggio perché consente di conservare la memoria video.In static scenarios, where neither the contents nor the use of the brush in the scene is changing, not caching the content provides a benefit because it conserves video memory. Quando un pennello con contenuto statico viene usato in modo non statico, il comportamento predefinito di WPFWPF consiste nel eseguire nuovamente il rendering di tutto il contenuto del pennello ogni frame, anche se il contenuto non cambia.When a brush with static content is used in a non-static way the default behavior of WPFWPF is to re-render all the content of the brush every frame, even though the content is unchanging. Questo problema si verifica ad esempio quando viene eseguito il mapping di un DrawingBrush o VisualBrush statico alla superficie di un oggetto 3D rotante.For example, this will happen when a static DrawingBrush or VisualBrush is mapped to the surface of a rotating 3D object. Il nuovo rendering del contenuto statico può avere un impatto negativo sulle prestazioni.Re-rendering the static content can have a negative impact on performance.

Impostando la proprietà CachingHint associata del pennello su Cache, è possibile migliorare le prestazioni utilizzando le versioni memorizzate nella cache degli oggetti pennello affiancati.By setting the CachingHint attached property on the brush to Cache, you can increase performance by using cached versions of the tiled brush objects.

I valori delle proprietà CacheInvalidationThresholdMinimum e CacheInvalidationThresholdMaximum sono valori di dimensione relativa che determinano la rigenerazione dell'oggetto TileBrush a causa delle modifiche della scala.The CacheInvalidationThresholdMinimum and CacheInvalidationThresholdMaximum property values are relative-size values that determine when the TileBrush object should be regenerated because of changes in scale. Se, ad esempio, la proprietà CacheInvalidationThresholdMinimum è impostata su 0,5, la cache per il TileBrush deve essere rigenerata solo quando la dimensione è ridotta a una metà delle dimensioni della cache corrente.For example, when the CacheInvalidationThresholdMinimum property is set to 0.5, the cache for the TileBrush needs to be regenerated only when its size is reduced to less than one half the size of the current cache.

Per accedere a questa proprietà nel codice, usare i metodi GetCacheInvalidationThresholdMinimum e SetCacheInvalidationThresholdMinimum.To access this property in code, use the GetCacheInvalidationThresholdMinimum and SetCacheInvalidationThresholdMinimum methods.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field CacheInvalidationThresholdMinimumProperty
Proprietà dei metadati impostate su trueMetadata properties set to true NoneNone

Si applica a

Vedi anche