UIElement.CacheMode Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit une valeur qui indique que le contenu rendu doit être mis en cache sous la forme d’une bitmap composite dans la mesure du possible.

public:
 property CacheMode ^ CacheMode { CacheMode ^ get(); void set(CacheMode ^ value); };

CacheMode CacheMode();

void CacheMode(CacheMode value);

public CacheMode CacheMode { get; set; }

var cacheMode = uIElement.cacheMode;
uIElement.cacheMode = cacheMode;

Public Property CacheMode As CacheMode

<uiElement CacheMode="BitmapCache" />

Valeur de propriété

CacheMode

Valeur qui indique que le contenu rendu doit être mis en cache sous forme de bitmap composite dans la mesure du possible. Si vous spécifiez la valeur CacheMode, les opérations de rendu à partir de RenderTransform et Opacity s’exécutent sur l’unité de traitement graphique (GPU), le cas échéant. La valeur par défaut est null, qui n’active pas le mode de composition mis en cache.

Remarques

Définissez cette valeur pour activer le comportement de mise en cache qui décharge les bitmaps RenderTransform et Opacity vers l’unité de traitement graphique (GPU). Sinon, laissez-le comme null.

Pour XAML, le littéral de chaîne « BitmapCache » est la seule valeur activée que vous pouvez utiliser pour définir CacheMode en tant qu’attribut.

Notes

BitmapCache est la seule classe dérivée pratique existante dans l’API Windows Runtime qui active ce comportement (le type CacheMode est un type intermédiaire qui existe uniquement pour des raisons d’infrastructure et héritées).

Si vous définissez CacheMode dans le code, définissez-le sur une nouvelle valeur bitmapCache, comme suit :

<Canvas x:Name="canvas1"/>

canvas1.CacheMode = new BitmapCache();

#include <winrt/Windows.UI.Xaml.Media.h>
...
canvas1().CacheMode(Windows::UI::Xaml::Media::BitmapCache{});

En règle générale, n’appliquez CacheMode pas de valeurs aux éléments sans tester et profiler d’abord. La mise en cache vers l’unité de traitement graphique (GPU) est destinée uniquement à une minorité de situations de rendu possibles pour une application, et il est attendu que vous profilez différentes combinaisons de quand et où dans votre interface utilisateur pour appliquer un CacheMode paramètre. La surutilisation de CacheMode peut nuire aux performances plutôt que de l’aider. Il est préférable de profiler la surface d’exposition de l’application pour déterminer les zones ciblées les plus coûteuses à afficher et d’expérimenter la mise en cache de certains éléments uniquement en fonction de ces résultats. Pour plus d’informations sur la façon de profiler pour le rendu, consultez la section « Mettre en cache le contenu statique » de la rubrique Optimiser votre balisage XAML .

Évitez d’utiliser CacheMode et les animations de table de montage séquentiel ensemble. La mise en cache du contenu où Opacity ou RenderTransform sont animés entraîne la dépendance des animations, même si l’animation est de durée nulle. Pour même voir ces animations exécutées, vous devez définir EnableDependentAnimationtruesur , et une animation dépendante invalide généralement tous les gains de performances que vous pouvez obtenir en mettant en cache la composition. L’opacité est souvent animée par des états visuels dans les modèles de contrôle. Il s’agit donc d’une considération même si vous ne déclarez pas vos propres animations de table de montage séquentiel dans les pages XAML.

Voir aussi

• Optimiser votre balisage XAML
• Animations dans une table de montage séquentiel