DependencyObject.ClearValue Metodo

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

Eccezioni

Esempio

Nell'esempio seguente vengono iterizzate tutte le proprietà con valori locali impostati su un oggetto e quindi viene chiamato ClearValue per cancellare i valori di ogni proprietà.

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

La cancellazione del valore della proprietà chiamando ClearValue non restituisce necessariamente una proprietà di dipendenza il valore predefinito specificato nei metadati della proprietà di dipendenza. La cancellazione della proprietà cancella solo in modo specifico il valore locale che potrebbe essere stato applicato. Per altre informazioni, vedere Precedenza del valore della proprietà di dipendenza.

Vedi anche

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

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

Eccezioni

Commenti

Un DependencyPropertyKey oggetto identifica una proprietà di dipendenza di sola lettura per le operazioni del sistema di proprietà. Le classi che definiscono le proprietà di dipendenza di sola lettura non devono esporre questa chiave con accesso pubblico. Una chiave esposta pubblicamente fornisce un percorso di codice pubblico che nega il carattere di sola lettura della proprietà, se i metodi come ClearValue o SetValue possono essere chiamati all'esterno della classe o dell'assembly, facendo riferimento alla chiave.

La cancellazione del valore della proprietà chiamando ClearValue non restituisce necessariamente una proprietà di dipendenza il valore predefinito specificato nei metadati della proprietà di dipendenza. La cancellazione del valore cancella solo in modo specifico qualsiasi valore locale sia stato applicato. Per altre informazioni, vedere Precedenza del valore della proprietà di dipendenza.

Vedi anche

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey