DependencyObject.ClearValue 方法

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)

參數

例外狀況

範例

以下範例會迭代所有物件上有局部值的屬性，然後呼叫 ClearValue 清除每個屬性的值。

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

備註

透過呼叫 ClearValue 清除屬性值，不一定會給相依屬性中指定的預設值。 清理房產只會明確清除可能被施加的當地價值。 欲了解更多資訊，請參閱 「相依財產價值優先次序」。

另請參閱

• 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)

參數

例外狀況

備註

A DependencyPropertyKey 識別屬性系統操作的唯讀依賴性質。 定義唯讀依賴屬性的類別不應公開此金鑰。 公開暴露的金鑰會提供一條公開程式碼路徑，若有像 或 ClearValue 這類方法SetValue可以在類別或組合外呼叫，並引用該金鑰，則可取消該屬性的唯讀特性。

透過呼叫 ClearValue 清除屬性值，不一定會給相依屬性中指定的預設值。 清除該價值只會明確清除可能已套用的當地價值。 欲了解更多資訊，請參閱 「相依財產價值優先次序」。

另請參閱

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey