UIElement.CacheMode Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 EnableDependentAnimation
true
sur , 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.