RenderOptions.SetCachingHint(DependencyObject, CachingHint) Metodo

Definizione

Imposta il valore della proprietà associata CachingHint su un oggetto dipendenza specificato.

public static void SetCachingHint (System.Windows.DependencyObject target, System.Windows.Media.CachingHint cachingHint);

Parametri

target
DependencyObject

Oggetto dipendenza per cui impostare il valore della proprietà CachingHint.

cachingHint
CachingHint

Nuovo valore su cui impostare la proprietà.

Eccezioni

Il valore specificato per il parametro target è null.

Esempio

Nell'esempio seguente viene illustrato come usare l'opzione hint per la memorizzazione nella cache per un oggetto DrawingBrush.

DrawingBrush drawingBrush = new DrawingBrush();
            
// Set the caching hint option for the brush.
RenderOptions.SetCachingHint(drawingBrush, CachingHint.Cache);

// Set the minimum and maximum relative sizes for regenerating the tiled brush.
// The tiled brush will be regenerated and re-cached when its size is
// 0.5x or 2x of the current cached size.
RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5);
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0);

Commenti

Per impostazione predefinita, WPF non memorizza nella cache il contenuto sottoposto a rendering di DrawingBrush oggetti e VisualBrush . Negli scenari statici, in cui né il contenuto né l'uso del pennello nella scena cambiano, non la memorizzazione nella cache offre un vantaggio perché consente di risparmiare memoria video. Quando un pennello con contenuto statico viene usato in modo non statico, il comportamento predefinito di WPF consiste nel eseguire nuovamente il rendering di tutto il contenuto del pennello ogni frame, anche se il contenuto non cambia. Ad esempio, ciò si verifica quando viene eseguito il mapping di un oggetto statico DrawingBrush o VisualBrush alla superficie di un oggetto 3D rotante. Il rendering del contenuto statico può avere un impatto negativo sulle prestazioni.

Impostando la CachingHint proprietà associata del pennello su Cache, è possibile aumentare le prestazioni usando le versioni memorizzate nella cache degli oggetti pennello affiancati.

I valori delle CacheInvalidationThresholdMinimum proprietà e CacheInvalidationThresholdMaximum sono valori di dimensioni relative che determinano quando l'oggetto TileBrush deve essere rigenerato a causa di modifiche nella scala. Ad esempio, quando la CacheInvalidationThresholdMaximum proprietà è impostata su 2.0, la cache per deve TileBrush essere rigenerata solo quando le dimensioni superano due volte le dimensioni della cache corrente.

Utilizzare questo metodo per impostare la CachingHint proprietà associata nel codice.

Si applica a

Prodotto Versioni
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

Vedi anche