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。 默认值为“无”。 使用此默认值时， BitmapImage 会在可用时使用缓存的内容。 对于通过统一资源标识符 (URI) 引用图像源文件而创建的 BitmapImage ，统一资源标识符 (URI) 控制内部缓存方案。

注解

CreateOptions 的另一个可能值是 BitmapCreateOptions.IgnoreImageCache。 只有在知道统一资源标识符检索到的源图像文件 (URI) 可能会随时间而更改的情况下，才应使用 BitmapCreateOptions.IgnoreImageCache 。 否则，将 CreateOptions 设置为使用 BitmapCreateOptions.IgnoreImageCache 会导致所有新检索到的图像源再次被解码，这可能会对性能产生负面影响。 BitmapCreateOptions.IgnoreImageCache 通常仅由直接操作文件位置中的图像并需要强制要求始终从位置（而不是缓存）重新加载任何 URI 确定的内容的设计工具使用。