BitmapImage.CacheOption Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property CacheOption As BitmapCacheOptionEigenschaftswert
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 |
