BitmapImage.CacheOption BitmapImage.CacheOption BitmapImage.CacheOption BitmapImage.CacheOption Property

Définition

Obtient ou définit le BitmapCacheOption à utiliser pour cette instance de BitmapImage.Gets or sets the BitmapCacheOption to use for this instance of BitmapImage.

public:
 property System::Windows::Media::Imaging::BitmapCacheOption CacheOption { System::Windows::Media::Imaging::BitmapCacheOption get(); void set(System::Windows::Media::Imaging::BitmapCacheOption value); };
public System.Windows.Media.Imaging.BitmapCacheOption CacheOption { get; set; }
member this.CacheOption : System.Windows.Media.Imaging.BitmapCacheOption with get, set
Public Property CacheOption As BitmapCacheOption

Valeur de propriété

BitmapCacheOption actuellement utilisé pour le BitmapImage.The BitmapCacheOption being used for the BitmapImage. La valeur par défaut est Default.The default is Default.

Exemples

L’exemple de code suivant montre comment définir le CacheOption d’un BitmapImage à l’aide de code.The following code example demonstrates how to set the CacheOption of a BitmapImage by using code.

// Define a BitmapImage.
Image myImage = new Image();
BitmapImage bi = new BitmapImage();

// Begin initialization.
bi.BeginInit();

// Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand;
bi.CreateOptions = BitmapCreateOptions.DelayCreation;
bi.DecodePixelHeight = 125;
bi.DecodePixelWidth = 125;
bi.Rotation = Rotation.Rotate90;
MessageBox.Show(bi.IsDownloading.ToString());
bi.UriSource = new Uri("smiley.png", UriKind.Relative);

// End initialization.
bi.EndInit();
myImage.Source = bi;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(5);
' Define a BitmapImage.
Dim myImage As New Image()
Dim bi As New BitmapImage()

' Begin initialization.
bi.BeginInit()

' Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand
bi.CreateOptions = BitmapCreateOptions.DelayCreation
bi.DecodePixelHeight = 125
bi.DecodePixelWidth = 125
bi.Rotation = Rotation.Rotate90
MessageBox.Show(bi.IsDownloading.ToString())
bi.UriSource = New Uri("smiley.png", UriKind.Relative)

' End initialization.
bi.EndInit()
myImage.Source = bi
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(5)

Remarques

Affectez CacheOption à BitmapCacheOption.OnLoad la valeur si vous souhaitez fermer un flux utilisé pour créer BitmapImagele.Set the CacheOption to BitmapCacheOption.OnLoad if you wish to close a stream used to create the BitmapImage. L’option OnDemand de cache par défaut conserve l’accès au flux jusqu’à ce que l’image soit nécessaire et que le nettoyage soit géré par le garbage collector.The default OnDemand cache option retains access to the stream until the image is needed, and cleanup is handled by the garbage collector.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field CacheOptionProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true Aucun.None

S’applique à

Voir aussi