BitmapImage.CreateOptions Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Media.Imaging

Ruft bitmapCreateOptions für ein BitmapImage ab oder legt diese fest.

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"/>

Eigenschaftswert

BitmapCreateOptions

Die BitmapCreateOptions, die für dieses BitmapImage verwendet werden. Der Standardwert ist None (Kein). Mit dieser Standardeinstellung verwendet ein BitmapImage zwischengespeicherte Inhalte, wenn er verfügbar ist. Für ein BitmapImage , das durch Verweisen auf eine Bildquelldatei mit dem URI (Uniform Resource Identifier) erstellt wird, steuert der URI (Uniform Resource Identifier) das interne Zwischenspeicherungsschema.

Hinweise

Der andere mögliche Wert für CreateOptions ist BitmapCreateOptions.IgnoreImageCache. Sie sollten BitmapCreateOptions.IgnoreImageCache nur in Fällen verwenden, in denen Sie wissen, dass sich die vom URI (Uniform Resource Identifier) abgerufene Quellbilddatei im Laufe der Zeit ändern kann. Andernfalls bewirkt das Festlegen von CreateOptions, dass BitmapCreateOptions.IgnoreImageCache verwendet wird, dass alle neu abgerufenen Bildquellen erneut decodiert werden, was sich negativ auf die Leistung auswirken kann. BitmapCreateOptions.IgnoreImageCache wird in der Regel nur von Designtools verwendet, die ein Bild direkt an einem Dateispeicherort bearbeiten und erzwingen müssen, dass URI-bestimmter Inhalt immer vom Speicherort und nicht aus dem Cache neu geladen wird.