DependencyObject.ClearValue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Cancella il valore locale di una proprietà.
Overload
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. |
| ClearValue(DependencyPropertyKey) |
Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. |
ClearValue(DependencyProperty)
Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty.
public:
void ClearValue(System::Windows::DependencyProperty ^ dp);public void ClearValue (System.Windows.DependencyProperty dp);member this.ClearValue : System.Windows.DependencyProperty -> unitPublic Sub ClearValue (dp As DependencyProperty)Parametri
Proprietà di dipendenza da cancellare, identificata da un riferimento a un oggetto DependencyProperty.
Eccezioni
Si è tentato di chiamare ClearValue(DependencyProperty) in un oggetto DependencyObject sealed.
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
Si applica a
ClearValue(DependencyPropertyKey)
Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.
public:
void ClearValue(System::Windows::DependencyPropertyKey ^ key);public void ClearValue (System.Windows.DependencyPropertyKey key);member this.ClearValue : System.Windows.DependencyPropertyKey -> unitPublic Sub ClearValue (key As DependencyPropertyKey)Parametri
Chiave per la proprietà di dipendenza da cancellare.
Eccezioni
Si è tentato di chiamare ClearValue(DependencyProperty) in un oggetto DependencyObject sealed.
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.
