BitmapImage.CreateOptions プロパティ

定義

名前空間:

Microsoft.UI.Xaml.Media.Imaging

BitmapImage の BitmapCreateOptions を取得または設定します。

public:
 property BitmapCreateOptions CreateOptions { BitmapCreateOptions get(); void set(BitmapCreateOptions value); };

BitmapCreateOptions CreateOptions();

void CreateOptions(BitmapCreateOptions value);

public BitmapCreateOptions CreateOptions { get; set; }

var bitmapCreateOptions = bitmapImage.createOptions;
bitmapImage.createOptions = bitmapCreateOptions;

Public Property CreateOptions As BitmapCreateOptions

<BitmapImage CreateOptions="bitmapCreateOptionsMemberName"/>

プロパティ値

BitmapCreateOptions

この BitmapImage に使用される BitmapCreateOptions。 既定値は [None](なし) です。 この既定値では、 BitmapImage はキャッシュされたコンテンツが使用可能な場合に使用します。 Uniform Resource Identifier (URI) によってイメージ ソース ファイルを参照して作成された BitmapImage の場合、Uniform Resource Identifier (URI) によって内部キャッシュ スキームが制御されます。

注釈

CreateOptions のもう 1 つの可能な値は 、BitmapCreateOptions.IgnoreImageCache です。 Uniform Resource Identifier (URI) によって取得されたソース イメージ ファイルが時間の経過と同時に変化する可能性があることがわかっている場合にのみ、 BitmapCreateOptions.IgnoreImageCache を使用する必要があります。 それ以外の場合、CreateOptions を BitmapCreateOptions.IgnoreImageCache を使用するように設定すると、新しく取得されたすべてのイメージ ソースが再びデコードされ、パフォーマンスに悪影響を与える可能性があります。 BitmapCreateOptions.IgnoreImageCache は通常、ファイルの場所でイメージを直接操作するデザイン ツールでのみ使用され、URI によって決定されたコンテンツがキャッシュからではなく、常に場所から再読み込みされるようにする必要があります。