BitmapImage.CreateOptions Eigenschaft

Definition

Ruft die BitmapCreateOptions für ein BitmapImage ab oder legt sie 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

Die BitmapCreateOptions , die für dieses BitmapImage verwendet werden. Der Standardwert ist "None". Bei dieser Standardeinstellung verwendet ein BitmapImage zwischengespeicherten Inhalt, wenn es verfügbar ist. Für ein BitmapImage , das durch Verweisen auf eine Bildquelldatei durch uniform Resource Identifier (URI) 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 die von uniform Resource Identifier (URI) abgerufene Quellbilddatei das Potenzial hat, sich im Laufe der Zeit zu ändern. Andernfalls bewirkt das Festlegen von CreateOptions für die Verwendung von BitmapCreateOptions.IgnoreImageCache , dass alle neu abgerufenen Bildquellen erneut decodiert werden, was sich negativ auf die Leistung auswirken kann. BitmapCreateOptions.IgnoreImageCache wird in der Regel nur von Entwurfstools verwendet, die ein Bild direkt an einem Dateispeicherort bearbeiten und erzwingen müssen, dass URI-bestimmter Inhalt immer aus dem Speicherort neu geladen wird, nicht aus dem Cache.

Gilt für: