DependencyObject.ClearValue Metodo

Definizione

Cancella il valore locale di una proprietà.Clears the local value of a property.

Overload

ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

public:
 void ClearValue(System::Windows::DependencyProperty ^ dp);
public void ClearValue (System.Windows.DependencyProperty dp);
member this.ClearValue : System.Windows.DependencyProperty -> unit
Public Sub ClearValue (dp As DependencyProperty)

Parametri

dp
DependencyProperty

Proprietà di dipendenza da cancellare, identificata da un riferimento a un oggetto DependencyProperty.The dependency property to be cleared, identified by a DependencyProperty object reference.

Eccezioni

Si è tentato di chiamare ClearValue(DependencyProperty) in un oggetto DependencyObject sealed.Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Esempi

Nell'esempio seguente vengono eseguite le iterazioni di tutte le proprietà con valori locali impostati su un oggetto, quindi viene chiamato ClearValue per cancellare i valori di ogni proprietà.The following example iterates all properties that have local values set on an object, then calls ClearValue to clear the values of each such property.

void RestoreDefaultProperties(object sender, RoutedEventArgs e)
{
    UIElementCollection uic = Sandbox.Children;
    foreach (Shape uie in uic)
    {
        LocalValueEnumerator locallySetProperties = uie.GetLocalValueEnumerator();
        while (locallySetProperties.MoveNext())
        {
            DependencyProperty propertyToClear = locallySetProperties.Current.Property;
            if (!propertyToClear.ReadOnly) { uie.ClearValue(propertyToClear); }
        }
    }
}
Private Sub RestoreDefaultProperties(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim uic As UIElementCollection = Sandbox.Children
    For Each uie As Shape In uic
        Dim locallySetProperties As LocalValueEnumerator = uie.GetLocalValueEnumerator()
        While locallySetProperties.MoveNext()
            Dim propertyToClear As DependencyProperty = locallySetProperties.Current.Property
            If Not propertyToClear.ReadOnly Then
                uie.ClearValue(propertyToClear)
            End If
        End While
    Next
End Sub

Commenti

Se si cancella il valore della proprietà chiamando ClearValue non viene assegnata necessariamente una proprietà di dipendenza al valore predefinito specificato nei metadati della proprietà di dipendenza.Clearing the property value by calling ClearValue does not necessarily give a dependency property the default value that is specified in the dependency property metadata. La cancellazione della proprietà comporta solo la cancellazione esplicita del valore locale che potrebbe essere stato applicato.Clearing the property only specifically clears whatever local value may have been applied. Per altre informazioni, vedere Precedenza del valore della proprietà di dipendenza.For more information, see Dependency Property Value Precedence.

Vedi anche

ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

public:
 void ClearValue(System::Windows::DependencyPropertyKey ^ key);
public void ClearValue (System.Windows.DependencyPropertyKey key);
member this.ClearValue : System.Windows.DependencyPropertyKey -> unit
Public Sub ClearValue (key As DependencyPropertyKey)

Parametri

key
DependencyPropertyKey

Chiave per la proprietà di dipendenza da cancellare.The key for the dependency property to be cleared.

Eccezioni

Si è tentato di chiamare ClearValue(DependencyProperty) in un oggetto DependencyObject sealed.Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Commenti

Un DependencyPropertyKey identifica una proprietà di dipendenza di sola lettura per le operazioni del sistema di proprietà.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Le classi che definiscono le proprietà di dipendenza di sola lettura non devono esporre questa chiave con accesso pubblico.Classes that define read-only dependency properties should not expose this key with public access. Una chiave esposta pubblicamente fornirebbe un percorso di codice pubblico che negava il carattere di sola lettura della proprietà, se metodi come ClearValue o SetValue potessero essere chiamati all'esterno della classe o dell'assembly, facendo riferimento alla chiave.A publicly exposed key would provide a public code pathway that negated the read-only character of the property, if methods such as ClearValue or SetValue could be called outside the class or assembly, referencing the key.

Se si cancella il valore della proprietà chiamando ClearValue non viene assegnata necessariamente una proprietà di dipendenza al valore predefinito specificato nei metadati della proprietà di dipendenza.Clearing the property value by calling ClearValue does not necessarily give a dependency property the default value that is specified in the dependency property metadata. La cancellazione del valore specifica solo il valore locale che potrebbe essere stato applicato.Clearing the value only specifically clears whatever local value may have been applied. Per altre informazioni, vedere Precedenza del valore della proprietà di dipendenza.For more information, see Dependency Property Value Precedence.

Vedi anche

Si applica a