DependencyObject.ClearValue Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht den lokalen Wert einer Eigenschaft.
Überlädt
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. |
| ClearValue(DependencyPropertyKey) |
Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. |
ClearValue(DependencyProperty)
Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.
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)Parameter
Die Abhängigkeitseigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Objektverweis identifiziert.
Ausnahmen
Es wurde versucht, ClearValue(DependencyProperty) für ein versiegeltes DependencyObject aufzurufen.
Beispiele
Das folgende Beispiel durchläuft alle Eigenschaften, die lokale Werte für ein Objekt festgelegt haben, und ruft dann auf ClearValue , um die Werte jeder solchen Eigenschaft zu löschen.
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
Hinweise
Durch das Löschen des Eigenschaftswerts durch Aufrufen ClearValue wird einer Abhängigkeitseigenschaft nicht unbedingt der Standardwert zurückgegeben, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist. Durch das Löschen der Eigenschaft wird nur der lokale Wert gelöscht, der möglicherweise angewendet wurde. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.
Weitere Informationen
Gilt für:
ClearValue(DependencyPropertyKey)
Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.
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)Parameter
Der Schlüssel für die Abhängigkeitseigenschaft, deren Wert gelöscht werden soll.
Ausnahmen
Es wurde versucht, ClearValue(DependencyProperty) für ein versiegeltes DependencyObject aufzurufen.
Hinweise
A DependencyPropertyKey identifiziert eine schreibgeschützte Abhängigkeitseigenschaft für Eigenschaftensystemvorgänge. Klassen, die schreibgeschützte Abhängigkeitseigenschaften definieren, sollten diesen Schlüssel nicht mit öffentlichem Zugriff verfügbar machen. Ein öffentlich verfügbar gemachter Schlüssel würde einen öffentlichen Codepfad bereitstellen, der das schreibgeschützte Zeichen der Eigenschaft negiert, wenn Methoden wie ClearValue oder SetValue außerhalb der Klasse oder Assembly aufgerufen werden könnten, die auf den Schlüssel verweisen.
Durch das Löschen des Eigenschaftswerts durch Aufrufen ClearValue wird einer Abhängigkeitseigenschaft nicht unbedingt der Standardwert zurückgegeben, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist. Das Löschen des Werts löscht nur den lokalen Wert, der möglicherweise angewendet wurde. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.
