Freigeben über


BitmapImage.CacheOption Eigenschaft

Definition

Ruft die BitmapCacheOption ab, die für diese Instanz von BitmapImage verwendet werden soll, oder legt diese fest.

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

Eigenschaftswert

Die für das BitmapCacheOption verwendete BitmapImage. Der Standardwert ist Default.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der CacheOption von einem BitmapImage mithilfe von Code festgelegt wird.

// 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)

Hinweise

Legen Sie auf CacheOption fest BitmapCacheOption.OnLoad , wenn Sie einen Stream schließen möchten, der zum Erstellen von BitmapImageverwendet wird. Die Standardcacheoption OnDemand behält den Zugriff auf den Stream bei, bis das Image benötigt wird, und die Bereinigung wird vom Garbage Collector verarbeitet.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld CacheOptionProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für:

Weitere Informationen