BitmapImage.CreateOptions Eigenschaft

Definition

Namespace:

Windows.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 durch Uniform Resource Identifier (URI) erstellt wird, steuert der Uniform Resource Identifier (URI) 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 Quellbilddatei, wie sie von Uniform Resource Identifier (URI) abgerufen wird, das Potenzial hat, sich im Laufe der Zeit zu ändern. Andernfalls werden durch Festlegen von CreateOptions auf BitmapCreateOptions.IgnoreImageCache alle neu abgerufenen Bildquellen erneut decodiert, 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 alle URI-ermittelten Inhalte immer vom Speicherort und nicht aus dem Cache neu geladen werden.