Partager via


PresentationOptions:Freeze, attribut

Définit l'état IsFrozen selon true sur l'élément Freezable contenant. Le comportement par défaut pour un Freezable sans l'attribut PresentationOptions:Freeze spécifié est que IsFrozen est false au moment du chargement, et dépendant du comportement Freezable général pendant l'exécution.

Utilisation d'attributs XAML

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

Valeurs XAML

PresentationOptions

Préfixe d'espace de noms XML, qui peut être toute chaîne de préfixe valide conforme à la spécification XML 1.0. Le préfixe PresentationOptions est utilisé à des fins d'identification dans cette documentation.

freezableElement

Élément qui instancie toute classe dérivée de Freezable.

Notes

L'attribut Freeze est le seul attribut ou élément de programmation défini dans l'espace de noms XML https://schemas.microsoft.com/winfx/2006/xaml/presentation/options. L'attribut Freeze existe spécifiquement dans cet espace de noms spécial afin qu'il puisse être désigné comme pouvant être ignoré, en utilisant l'mc:Ignorable, attribut dans le cadre des déclarations d'élément racine. La raison pour laquelle Freeze doit être en mesure de pouvoir être ignoré est parce que toutes les implémentations de processeur XAML ne sont pas en mesure de figer un Freezable au moment du chargement ; cette fonctionnalité ne faisant pas partie de la spécification XAML.

La capacité à traiter l'attribut Freeze est intégrée spécifiquement au processeur XAML qui traite XAML pour les applications compilées. L'attribut n'est pris en charge par aucune classe, et la syntaxe d'attribut n'est pas extensible ou modifiable. Si vous implémentez votre propre processeur XAML, vous pouvez choisir de placer parallèlement le comportement de gel du processeur WPFXAML lors du traitement de l'attribut Freeze sur les éléments Freezable au moment du chargement.

Toute valeur pour l'attribut Freeze autre que true (non sensible à la casse) génère une erreur au moment du chargement. (Spécifier l'attribut Freeze comme étant false ne constitue pas une erreur, mais comme il s'agit déjà de la valeur par défaut, le fait de spécifier false n'accomplit rien).

Voir aussi

Référence

Freezable

mc:Ignorable, attribut

Concepts

Vue d'ensemble des objets Freezable