Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Freezable, classe

.NET Framework 4.5

Autres versions

Définit un objet qui a un état modifiable et un état en lecture seule (figé). Les classes qui dérivent de Freezable fournissent une notification de modifications détaillée, peuvent être rendues immuables et peuvent être clonées.

Hiérarchie d'héritage

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        En savoir plus...

Espace de noms : System.Windows
Assembly : WindowsBase (dans WindowsBase.dll)

Syntaxe

C++

public abstract class Freezable : DependencyObject

Le type Freezable expose les membres suivants.

Constructeurs

	Nom	Description
	Freezable	Initialise une nouvelle instance d'une classe dérivée de Freezable.

Début

Propriétés

	Nom	Description
	CanFreeze	Obtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable.
	DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject.)
	Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
	IsFrozen	Obtient une valeur qui indique si l'objet est actuellement modifiable ou pas.
	IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)

Début

Méthodes

	Nom	Description
	CheckAccess	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
	ClearValue(DependencyProperty)	Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
	ClearValue(DependencyPropertyKey)	Efface la valeur de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject.)
	Clone	Crée un clone modifiable de Freezable, en créant des copies complètes des valeurs de l'objet. Lors de la copie des propriétés de dépendance de l'objet, cette méthode copie les expressions (qui risquent de ne plus pouvoir se résoudre) mais pas les animations ou leurs valeurs actuelles.
	CloneCore	Convertit l'instance en clone (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base.
	CloneCurrentValue	Crée un clone modifiable (copie complète) de Freezable en utilisant ses valeurs actuelles.
	CloneCurrentValueCore	Convertit l'instance en clone modifiable (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés actuelles.
	CoerceValue	Force la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant. (Hérité de DependencyObject.)
	CreateInstance	Initialise une nouvelle instance de la classe Freezable.
	CreateInstanceCore	Une fois implémentée dans une classe dérivée, initialise une nouvelle instance de la classe dérivée Freezable.
	Equals	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	Freeze()	Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true.
	Freeze(Freezable, Boolean)	Si le paramètre isChecking est true, cette méthode indique si le Freezable spécifié peut être rendu non modifiable ou pas. Si le paramètre isChecking est false, cette méthode essaie de rendre le Freezable spécifié non modifiable et indique si l'opération a réussi.
	FreezeCore	Rend l'objet Freezable non modifiable ou vérifie si celui-ci peut être rendu non modifiable ou pas.
	GetAsFrozen	Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.
	GetAsFrozenCore	Convertit l'instance en clone figé du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base.
	GetCurrentValueAsFrozen	Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.
	GetCurrentValueAsFrozenCore	Convertit l'instance actuelle en un clone figé du Freezable spécifié. Si l'objet comporte des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées.
	GetHashCode	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
	GetLocalValueEnumerator	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	GetValue	Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
	InvalidateProperty	Réévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	OnChanged	Appelé lors de la modification de l'objet Freezable actuel.
	OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini.
	OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ce membre prend en charge l'infrastructure Windows Presentation Foundation (WPF) et n'est pas conçu pour être directement utilisé à partir du code.
	OnPropertyChanged	Substitue l'implémentation DependencyObject de OnPropertyChanged pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable. (Substitue DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs).)
	ReadLocalValue	Retourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
	ReadPreamble	Garantit que Freezable est accessible à partir d'un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance.
	SetCurrentValue	Définit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
	SetValue(DependencyProperty, Object)	Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
	SetValue(DependencyPropertyKey, Object)	Définit la valeur de proximité d'une propriété de dépendance en lecture seule, spécifiée par l'identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject.)
	ShouldSerializeProperty	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie. (Hérité de DependencyObject.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
	VerifyAccess	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
	WritePostscript	Déclenche l'événement Changed pour Freezable et appelle sa méthode OnChanged. Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe non stockés en tant que propriétés de dépendance.
	WritePreamble	Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant les membres de données qui ne sont pas des propriétés de dépendance.

Début

Événements

	Nom	Description
	Changed	Se produit lorsque Freezable ou un objet qu'il contient est modifié.

Début

Notes

La classe Freezable fournit des fonctionnalités spéciales pouvant aider à améliorer les performances d'application lors de l'utilisation d'objets coûteux à modifier ou à copier. Voici quelques exemples d'objets Freezable :

Dérivation de Freezable

Une classe qui dérive de Freezable acquiert les fonctionnalités suivantes :

États spéciaux : un état en lecture seule (figé) et un état d'écriture.
Sécurité des threads : un objet Freezable figé peut être partagé entre plusieurs threads.
Notification de modifications détaillée : contrairement à d'autres objets DependencyObject, un objet Freezable fournit des notifications de modifications lorsque les valeurs de sous-propriété sont modifiées.
Clonage facile : la classe Freezable a déjà implémenté plusieurs méthodes qui génèrent des clones complets.

Pour plus d'informations sur l'utilisation et la création de vos propres objets Freezable, consultez Vue d'ensemble des objets Freezable.

Informations de version

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads

Tous les membres static publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Lorsque la propriété IsFrozen est false, un objet Freezable est uniquement accessible à partir du thread sur lequel il a été créé. Toute tentative d'y accéder à partir d'un autre thread lève une InvalidOperationException. Les méthodes Dispatcher.Invoke et Dispatcher.BeginInvoke fournissent une prise en charge pour marshaler vers le thread correct.

Lorsque leur propriété IsFrozen est true, les objets Freezable sont libres de threads. Pour plus d'informations, consultez Vue d'ensemble des objets Freezable.

Voir aussi

Référence

System.Windows, espace de noms

Autres ressources

Vue d'ensemble des objets Freezable

Hiérarchie d'héritage

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER