PresentationOptions:Freeze-Attribut

Aktualisiert: November 2007

Legt den IsFrozen-Zustand im enthaltenden Freezable-Element auf true fest. Als Standardverhalten von Freezable ohne Angabe des PresentationOptions:Freeze-Attributs gilt: IsFrozen ist bei Ladezeit false und vom allgemeinen Freezable-Verhalten zur Laufzeit abhängig.

Verwendung von XAML-Attributen

<object
  xmlns:PresentationOptions="https://schemas.microsoft.com/winfx/2006/xaml/presentation/options"
  xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="PresentationOptions">
    <freezableElement PresentationOptions:Freeze="true"/>
</object>

XAML-Werte

PresentationOptions

Ein XML-Namespace, der jede gültige Präfixzeichenfolge gemäß der XML 1.0-Spezifikation sein kann. Das Präfix PresentationOptions wird in dieser Dokumentation für Identifikationszwecke verwendet.

freezableElement

Ein Element, das jede abgeleitete Klasse von Freezable instanziiert.

Hinweise

Das Freeze-Attribut ist das einzige Attribut oder ein anderes, im https://schemas.microsoft.com/winfx/2006/xaml/presentation/options XML-Namespace definiertes Element. Das Freeze-Attribut ist in diesem speziellen Namespace spezifisch so vorhanden, dass es als ignorierbar bezeichnet werden kann. mc:Ignorable-Attribut wird als Teil der Stammelementdeklarationen verwendet. Der Grund, aus dem Freeze ignorierbar sein können muss, liegt darin, dass alle XAML-Prozessorimplementierungen in der Lage sind, ein Freezable bei Ladezeit zu sperren. Diese Fähigkeit ist nicht Teil der XAML-Spezifikation.

Die Möglichkeit zur Verarbeitung des Freeze-Attributs ist speziell in den XAML-Prozessor integriert, der XAML für kompilierte Anwendungen verarbeitet. Das Attribut wird von keiner Klasse unterstützt, und die Attributsyntax ist nicht erweiterbar oder änderbar. Wenn Sie einen eigenen XAML-Prozessor implementieren, können Sie festlegen, dass das Sperrverhalten des WPF XAML-Prozessors beim Verarbeiten des Freeze-Attributes für Freezable-Elemente bei Ladezeit entsprechend ist.

Wenn das Freeze-Attribut einen anderen Wert als true (ohne Beachtung von Groß-/Kleinschreibung) hat, wird ein Ladezeitfehler generiert. (Wenn für das Freeze-Attribut der Wert false angegeben wird, so ist das kein Fehler, sondern bereits die Standardeinstellung, d. h. die Einstellung auf false hat keine Wirkung).

Siehe auch

Konzepte

Übersicht über Freezable-Objekte

Referenz

Freezable

mc:Ignorable-Attribut