BitmapImage.CreateOptions Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Media.Imaging

Obtient ou définit bitmapCreateOptions pour une Image Bitmap.

public:
 property BitmapCreateOptions CreateOptions { BitmapCreateOptions get(); void set(BitmapCreateOptions value); };

BitmapCreateOptions CreateOptions();

void CreateOptions(BitmapCreateOptions value);

public BitmapCreateOptions CreateOptions { get; set; }

var bitmapCreateOptions = bitmapImage.createOptions;
bitmapImage.createOptions = bitmapCreateOptions;

Public Property CreateOptions As BitmapCreateOptions

<BitmapImage CreateOptions="bitmapCreateOptionsMemberName"/>

Valeur de propriété

BitmapCreateOptions

BitmapCreateOptions utilisée pour cette Image Bitmap. La valeur par défaut est None (Aucun). Avec cette valeur par défaut, un BitmapImage utilise du contenu mis en cache lorsqu’il est disponible. Pour un BitmapImage créé en référençant un fichier source d’image par URI (Uniform Resource Identifier), l’URI (Uniform Resource Identifier) contrôle le schéma de mise en cache interne.

Remarques

L’autre valeur possible pour CreateOptions est BitmapCreateOptions.IgnoreImageCache. Vous ne devez utiliser BitmapCreateOptions.IgnoreImageCache que dans les cas où vous savez que le fichier image source tel que récupéré par l’URI (Uniform Resource Identifier) a le potentiel de changer au fil du temps. Sinon, la définition de CreateOptions pour utiliser BitmapCreateOptions.IgnoreImageCache entraîne le décodage de toutes les sources d’images nouvellement récupérées, ce qui peut avoir un impact négatif sur les performances. BitmapCreateOptions.IgnoreImageCache est généralement utilisé uniquement par les outils de conception qui manipulent directement une image dans un emplacement de fichier et doivent appliquer que tout contenu déterminé par l’URI est toujours rechargé à partir de l’emplacement, et non à partir du cache.