Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Freezable-Klasse

.NET Framework 4

Andere Versionen

Definiert ein Objekt mit einem änderbaren Zustand und einem schreibgeschützten (fixierten) Zustand. Klassen, die von Freezable abgeleitet sind, stellen ausführliche Änderungsbenachrichtigung bereit, können als nicht änderbar festgelegt werden und können sich klonen.

Vererbungshierarchie

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        Weitere Informationen...

Namespace: System.Windows
Assembly: WindowsBase (in WindowsBase.dll)

Syntax

C++

Kopieren

public abstract class Freezable : DependencyObject

Der Freezable-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	Freezable	Initialisiert eine neue Instanz einer abgeleiteten Freezable-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	CanFreeze	Ruft einen Wert ab, der angibt, ob das Objekt als nicht änderbar festgelegt werden kann.
	DependencyObjectType	Ruft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt. (Von DependencyObject geerbt.)
	Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
	IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt gegenwärtig änderbar ist.
	IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CheckAccess	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
	ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben. (Von DependencyObject geerbt.)
	ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyPropertyKey angegeben. (Von DependencyObject geerbt.)
	Clone	Erstellt einen änderbaren Klon der Freezable, indem tiefe Kopien von den Werten des Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften des Objekts kopiert diese Methode Ausdrücke (die jedoch möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte.
	CloneCore	Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert).
	CloneCurrentValue	Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten.
	CloneCurrentValueCore	Definiert die Instanz mit aktuellen Eigenschaftswerten als änderbaren Klon (tiefe Kopie) des angegebenen Freezable.
	CoerceValue	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Für die Umwandlung wird eine vorhandene CoerceValueCallback-Funktion aufgerufen, die in den Metadaten der Abhängigkeitseigenschaft für das aufrufende DependencyObject angegeben ist. (Von DependencyObject geerbt.)
	CreateInstance	Initialisiert eine neue Instanz der Freezable-Klasse.
	CreateInstanceCore	Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse.
	Equals	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Von DependencyObject geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
	Freeze()	Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest.
	Freeze(Freezable, Boolean)	Wenn der isChecking-Parameter true ist, gibt diese Methode an, ob das angegebene Freezable als nicht änderbar festgelegt werden kann. Wenn der isChecking-Parameter false ist, versucht diese Methode, das angegebene Freezable als nicht änderbar festzulegen und gibt an, ob der Vorgang erfolgreich ausgeführt wurde.
	FreezeCore	Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann.
	GetAsFrozen	Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.
	GetAsFrozenCore	Definiert die Instanz als fixierten Klon des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert).
	GetCurrentValueAsFrozen	Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.
	GetCurrentValueAsFrozenCore	Legt die aktuelle Instanz als fixierten Klon des angegebenen Freezable fest. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert.
	GetHashCode	Ruft einen Hashcode für dieses DependencyObject ab. (Von DependencyObject geerbt.)
	GetLocalValueEnumerator	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Von DependencyObject geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetValue	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft in dieser Instanz eines DependencyObject zurück. (Von DependencyObject geerbt.)
	InvalidateProperty	Berechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neu (Von DependencyObject geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	OnChanged	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird.
	OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden.
	OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Der Member unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.
	OnPropertyChanged	Überschreibt die DependencyObject-Implementierung von OnPropertyChanged, um auch alle Changed-Handler als Reaktion auf eine Änderung einer Abhängigkeitseigenschaft vom Typ Freezable aufzurufen. (Überschreibt DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs).)
	ReadLocalValue	Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück. (Von DependencyObject geerbt.)
	ReadPreamble	Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Erben von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.
	SetCurrentValue	Legt den Wert einer -Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Von DependencyObject geerbt.)
	SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird. (Von DependencyObject geerbt.)
	SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die über ihren DependencyPropertyKey-Bezeichner angegeben wird. (Von DependencyObject geerbt.)
	ShouldSerializeProperty	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Von DependencyObject geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	VerifyAccess	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
	WritePostscript	Löst das Changed-Ereignis für Freezable aus und ruft seine OnChanged-Methode auf. Von Freezable abgeleitete Klassen sollten diese Methode am Ende jeder API aufrufen, die nicht als Abhängigkeitseigenschaften gespeicherte Klassenmember ändert.
	WritePreamble	Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Erben von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	Changed	Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird.

Zum Seitenanfang

Hinweise

Die Freezable-Klasse stellt besondere Features bereit, mit denen die Anwendungsleistung bei der Verwendung von Objekten verbessert werden kann, bei denen Änderungen und Kopiervorgänge ressourcenintensiv sind. Im Folgenden sind Beispiele für Freezable-Objekte aufgeführt:

Ableiten von Freezable

Eine von Freezable abgeleitete Klasse erhält die folgenden Features:

Besondere Zustände: Ein schreibgeschützter (fixierter) Zustand und ein nicht schreibgeschützter Zustand.
Threadsicherheit: Ein fixiertes Freezable-Objekt kann über Threads freigegeben werden.
Ausführliche Änderungsbenachrichtigung: Im Gegensatz zu anderen DependencyObject-Objekten stellt ein Freezable-Objekt Änderungsbenachrichtigungen bereit, wenn Werte von Untereigenschaften geändert werden.
Leichtes Klonen: In der Freezable-Klasse sind bereits mehrere Methoden implementiert, die tiefe Klone erstellen.

Informationen zum Verwenden und Erstellen eigener Freezable-Objekte finden Sie unter Übersicht über Freezable-Objekte.

Versionsinformationen

.NET Framework

Unterstützt in: 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Plattformen

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Wenn die IsFrozen-Eigenschaft den Wert false hat, kann auf ein Freezable-Objekt nur über den Thread zugegriffen werden, in dem es erstellt wurde. Der Versuch des Zugriffs über einen anderen Thread löst eine InvalidOperationException aus. Die Dispatcher.Invoke-Methode und die Dispatcher.BeginInvoke-Methode unterstützen Marshalling zum richtigen Thread.

Wenn ihre IsFrozen-Eigenschaft true ist, werden Freezable-Objekte zu Freethreadobjekten. Weitere Informationen finden Sie unter Übersicht über Freezable-Objekte.

Siehe auch

Referenz

System.Windows-Namespace

Weitere Ressourcen

Übersicht über Freezable-Objekte

Vererbungshierarchie

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Inhalt Hinzufügen

FAQ

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?

Informationen zur Datensicherheit