BitmapImage.CacheOption 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置要用于此 BitmapCacheOption 实例的 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, setPublic Property CacheOption As BitmapCacheOption属性值
用于 BitmapCacheOption 的 BitmapImage。 默认值为 Default。
示例
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)
注解
Set the CacheOption to BitmapCacheOption.OnLoad if you wish to close a stream used to create the BitmapImage. 默认 OnDemand 缓存选项将保留对流的访问，直到需要映像，并且垃圾回收器会处理清理。
依赖项属性信息
| 标识符字段 | CacheOptionProperty |
元数据属性设置为 true |
无 |