Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe Freezable

 

Data di pubblicazione: ottobre 2016

Definisce un oggetto che ha uno stato modificabile e uno stato di sola lettura (bloccato). Le classi che derivano da Freezable forniscono una notifica dettagliata delle modifiche, possono essere rese non modificabili e possono clonare se stesse.

Spazio dei nomi:   System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Controls.Ribbon.RibbonControlSizeDefinition
        System.Windows.Controls.Ribbon.RibbonGroupSizeDefinitionBase
        System.Windows.Input.InputBinding
        System.Windows.Media.Animation.Animatable
        System.Windows.Media.Animation.BooleanKeyFrame
        System.Windows.Media.Animation.BooleanKeyFrameCollection
        System.Windows.Media.Animation.ByteKeyFrame
        System.Windows.Media.Animation.ByteKeyFrameCollection
        System.Windows.Media.Animation.CharKeyFrame
        System.Windows.Media.Animation.CharKeyFrameCollection
        System.Windows.Media.Animation.ColorKeyFrame
        System.Windows.Media.Animation.ColorKeyFrameCollection
        System.Windows.Media.Animation.DecimalKeyFrame
        System.Windows.Media.Animation.DecimalKeyFrameCollection
        System.Windows.Media.Animation.DoubleKeyFrame
        System.Windows.Media.Animation.DoubleKeyFrameCollection
        System.Windows.Media.Animation.EasingFunctionBase
        System.Windows.Media.Animation.Int16KeyFrame
        System.Windows.Media.Animation.Int16KeyFrameCollection
        System.Windows.Media.Animation.Int32KeyFrame
        System.Windows.Media.Animation.Int32KeyFrameCollection
        System.Windows.Media.Animation.Int64KeyFrame
        System.Windows.Media.Animation.Int64KeyFrameCollection
        System.Windows.Media.Animation.KeySpline
        System.Windows.Media.Animation.MatrixKeyFrame
        System.Windows.Media.Animation.MatrixKeyFrameCollection
        System.Windows.Media.Animation.ObjectKeyFrame
        System.Windows.Media.Animation.ObjectKeyFrameCollection
        System.Windows.Media.Animation.Point3DKeyFrame
        System.Windows.Media.Animation.Point3DKeyFrameCollection
        System.Windows.Media.Animation.PointKeyFrame
        System.Windows.Media.Animation.PointKeyFrameCollection
        System.Windows.Media.Animation.QuaternionKeyFrame
        System.Windows.Media.Animation.QuaternionKeyFrameCollection
        System.Windows.Media.Animation.RectKeyFrame
        System.Windows.Media.Animation.RectKeyFrameCollection
        System.Windows.Media.Animation.Rotation3DKeyFrame
        System.Windows.Media.Animation.Rotation3DKeyFrameCollection
        System.Windows.Media.Animation.SingleKeyFrame
        System.Windows.Media.Animation.SingleKeyFrameCollection
        System.Windows.Media.Animation.SizeKeyFrame
        System.Windows.Media.Animation.SizeKeyFrameCollection
        System.Windows.Media.Animation.StringKeyFrame
        System.Windows.Media.Animation.StringKeyFrameCollection
        System.Windows.Media.Animation.ThicknessKeyFrame
        System.Windows.Media.Animation.ThicknessKeyFrameCollection
        System.Windows.Media.Animation.Vector3DKeyFrame
        System.Windows.Media.Animation.Vector3DKeyFrameCollection
        System.Windows.Media.Animation.VectorKeyFrame
        System.Windows.Media.Animation.VectorKeyFrameCollection
        System.Windows.Media.DoubleCollection
        System.Windows.Media.ImageMetadata
        System.Windows.Media.Int32Collection
        System.Windows.Media.Media3D.GeneralTransform2DTo3D
        System.Windows.Media.Media3D.GeneralTransform3DTo2D
        System.Windows.Media.Media3D.Point3DCollection
        System.Windows.Media.Media3D.Vector3DCollection
        System.Windows.Media.PointCollection
        System.Windows.Media.VectorCollection
        System.Windows.Shell.TaskbarItemInfo
        System.Windows.Shell.ThumbButtonInfo
        System.Windows.Shell.WindowChrome

public abstract class Freezable : DependencyObject

NomeDescrizione
System_CAPS_protmethodFreezable()

Inizializza una nuova istanza di un Freezable classe derivata.

NomeDescrizione
System_CAPS_pubpropertyCanFreeze

Ottiene un valore che indica se l'oggetto può essere impostato come non modificabile.

System_CAPS_pubpropertyDependencyObjectType

Ottiene il DependencyObjectType che esegue il wrapping di CLR tipo di questa istanza. (Ereditato da DependencyObject.)

System_CAPS_pubpropertyDispatcher

Ottiene il Dispatcher questo DispatcherObject è associato.(Ereditato da DispatcherObject.)

System_CAPS_pubpropertyIsFrozen

Ottiene un valore che indica se l'oggetto è attualmente modificabile.

System_CAPS_pubpropertyIsSealed

Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura).(Ereditato da DependencyObject.)

NomeDescrizione
System_CAPS_pubmethodCheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObject.(Ereditato da DispatcherObject.)

System_CAPS_pubmethodClearValue(DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty.(Ereditato da DependencyObject.)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.(Ereditato da DependencyObject.)

System_CAPS_pubmethodClone()

Crea un clone modificabile dell'oggetto Freezable, eseguendo copie complete dei valori dell'oggetto. Durante la copia delle proprietà di dipendenza di questo oggetto, questo metodo copia le espressioni (che potrebbero non essere più risolte), ma non le animazioni né i relativi valori correnti.

System_CAPS_protmethodCloneCore(Freezable)

Rende l'istanza un clone (copia completa) dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati).

System_CAPS_pubmethodCloneCurrentValue()

Crea un clone modificabile (copia completa) del Freezable utilizzando i valori correnti.

System_CAPS_protmethodCloneCurrentValueCore(Freezable)

Rende l'istanza un clone (copia completa) modificabile dell'oggetto Freezable specificato usando i valori di proprietà correnti.

System_CAPS_pubmethodCoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.(Ereditato da DependencyObject.)

System_CAPS_protmethodCreateInstance()

Inizializza una nuova istanza della classe Freezable.

System_CAPS_protmethodCreateInstanceCore()

Quando implementato in una classe derivata, crea una nuova istanza di Freezable classe derivata.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto DependencyObject è equivalente all'oggetto corrente DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.(Ereditato da Object.)

System_CAPS_pubmethodFreeze()

Rende non modificabile l'oggetto corrente e ne imposta la proprietà IsFrozen su true.

System_CAPS_protmethodSystem_CAPS_staticFreeze(Freezable, Boolean)

Se il isChecking parametro true, questo metodo indica se l'oggetto specificato Freezable può essere reso non modificabile. Se il isChecking parametro false, questo metodo tenta di rendere specificato Freezable non modificabile e indica se l'operazione è riuscita.

System_CAPS_protmethodFreezeCore(Boolean)

Rende il Freezable oggetto o verifica se è possibile renderla non modificabile.

System_CAPS_pubmethodGetAsFrozen()

Crea una copia di bloccata la Freezable, utilizzando i valori di proprietà di base (non animati). Poiché la copia è bloccata, gli oggetti secondari bloccati vengono copiati per riferimento.

System_CAPS_protmethodGetAsFrozenCore(Freezable)

Rende l'istanza un clone bloccato dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati).

System_CAPS_pubmethodGetCurrentValueAsFrozen()

Crea una copia di bloccata la Freezable utilizzando i valori di proprietà correnti. Poiché la copia è bloccata, gli oggetti secondari bloccati vengono copiati per riferimento.

System_CAPS_protmethodGetCurrentValueAsFrozenCore(Freezable)

Rende l'istanza corrente un clone bloccato dell'oggetto Freezable specificato. Se l'oggetto ha proprietà di dipendenza animate, i valori animati correnti vengono copiati.

System_CAPS_pubmethodGetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare quali proprietà di dipendenza presentano valori impostati localmente su questo DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Rivaluta il valore effettivo della proprietà di dipendenza specificata(Ereditato da DependencyObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnChanged()

Chiamato quando l'oggetto corrente Freezable oggetto viene modificato.

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject)

Assicura che adatti puntatori del contesto vengono stabiliti per un DependencyObjectType (membro dati) che è appena stato impostato.

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice.

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Esegue l'override dell'implementazione di DependencyObject di OnPropertyChanged per richiamare anche eventuali gestori Changed in risposta alla modifica di una proprietà di dipendenza di tipo Freezable.(Esegue l'override di DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs).)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se presente.(Ereditato da DependencyObject.)

System_CAPS_protmethodReadPreamble()

Assicura che il Freezable si accede da un thread valido. Gli eredi Freezable necessario chiamare questo metodo all'inizio di qualsiasi API che legge i membri di dati che non sono proprietà di dipendenza.

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.(Ereditato da DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.(Ereditato da DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.(Ereditato da DependencyObject.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.(Ereditato da DependencyObject.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente.(Ereditato da Object.)

System_CAPS_pubmethodVerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObject.(Ereditato da DispatcherObject.)

System_CAPS_protmethodWritePostscript()

Genera l'evento Changed per Freezable e richiama il metodo OnChanged. Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri di classe che non sono archiviati come proprietà di dipendenza.

System_CAPS_protmethodWritePreamble()

Verifica che il Freezable non sia bloccato e che si accede da un contesto di threading valido. Freezable gli eredi devono chiamare questo metodo all'inizio di qualsiasi API che scrive i membri di dati che non sono proprietà di dipendenza.

NomeDescrizione
System_CAPS_pubeventChanged

Si verifica quando il Freezable o si modifica un oggetto che contiene.

La Freezable classe fornisce funzionalità speciali che consentono di migliorare le prestazioni dell'applicazione quando si utilizzano gli oggetti che sono costosi da modificare o copiare. Esempi di Freezable oggetti includono quanto segue:

Una classe che deriva da Freezable Ottiene le funzionalità seguenti:

  • Stati speciali: stato di sola lettura (bloccato) e uno stato modificabile.

  • Sicurezza dei thread: un oggetto bloccato Freezable oggetto può essere condivisi tra thread.

  • Notifica dettagliata delle modifiche: a differenza degli altri DependencyObject oggetti, un Freezable oggetto fornisce notifiche di modifica quando si modificano i valori delle sottoproprietà.

  • Clonazione facile: la classe Freezable ha già implementato diversi metodi che producono cloni.

Per informazioni sull'utilizzo e crearne una propria Freezable degli oggetti, vedere Cenni preliminari sugli oggetti Freezable.

.NET Framework
Disponibile da 3.0

Qualsiasi membro pubblico static di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Quando il IsFrozen è false, Freezable oggetto è accessibile solo dal thread su cui è stato creato. Il tentativo di accesso da un altro thread genererà un InvalidOperationException. Il Dispatcher.Invoke e Dispatcher.BeginInvoke metodi forniscono supporto per il marshalling al thread corretto.

Quando i relativi IsFrozen proprietà true, Freezable sono oggetti a thread libero. Per ulteriori informazioni, vedere Cenni preliminari sugli oggetti Freezable.

Torna all'inizio
Mostra: