BitmapImage.CacheOption プロパティ

定義

名前空間:

System.Windows.Media.Imaging

アセンブリ:

PresentationCore.dll

BitmapCacheOption のこのインスタンスで使用する BitmapImage を取得または設定します。

public System.Windows.Media.Imaging.BitmapCacheOption CacheOption { get; set; }

プロパティ値

BitmapCacheOption

BitmapCacheOption で使用されている BitmapImage。 既定値は、Default です。

例

次のコード例では、コードを使用して の BitmapImage をCacheOption設定する方法を示します。

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

注釈

をCacheOptionBitmapCacheOption.OnLoad作成するために使用されるストリームを閉じる場合は、 を に設定しますBitmapImage。 既定 OnDemand のキャッシュ オプションは、イメージが必要になるまでストリームへのアクセスを保持し、クリーンアップはガベージ コレクターによって処理されます。

依存プロパティ情報

識別子フィールド	CacheOptionProperty
に設定されたメタデータ プロパティ true	なし

適用対象

こちらもご覧ください

• BitmapCacheOption