RenderOptions.SetCachingHint(DependencyObject, CachingHint) Metodo
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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);
public static void SetCachingHint (System.Windows.DependencyObject target, System.Windows.Media.CachingHint cachingHint);
static member SetCachingHint : System.Windows.DependencyObject * System.Windows.Media.CachingHint -> unit
Public Shared Sub SetCachingHint (target As DependencyObject, cachingHint As CachingHint)
- target
- DependencyObject
Oggetto dipendenza per cui impostare il valore della proprietà CachingHint.
- cachingHint
- CachingHint
Nuovo valore su cui impostare la proprietà.
Il valore specificato per il parametro target
è null
.
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);
Dim drawingBrush As 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)
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.
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 |