DependencyObject.ClearValue 方法

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

清除屬性的區域數值。

多載

ClearValue(DependencyProperty)	清除屬性的區域數值。 要清除的屬性是由 DependencyProperty 識別項所指定。
ClearValue(DependencyPropertyKey)	清除唯讀屬性的區域數值。 要清除的屬性是由 DependencyPropertyKey 所指定。

ClearValue(DependencyProperty)

清除屬性的區域數值。 要清除的屬性是由 DependencyProperty 識別項所指定。

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)

參數

dp

DependencyProperty

要清除的相依性屬性，該屬性是由 DependencyProperty 物件參考所識別。

例外狀況

InvalidOperationException

嘗試在密封的 DependencyObject 上呼叫 ClearValue(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

ClearValue(DependencyPropertyKey)

清除唯讀屬性的區域數值。 要清除的屬性是由 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)

參數

key

DependencyPropertyKey

要清除之相依性屬性的索引鍵。

例外狀況

InvalidOperationException

嘗試在密封的 DependencyObject 上呼叫 ClearValue(DependencyProperty)。

備註

DependencyPropertyKey識別屬性系統作業的唯讀相依性屬性。 定義唯讀相依性屬性的類別不應該公開具有公用存取權的此金鑰。 公開的索引鍵會提供公用程式代碼路徑，以否定 屬性的唯讀字元，如果 或 之類的 ClearValue SetValue 方法可以在 類別或元件之外呼叫，則參考索引鍵。

呼叫 ClearValue 來清除屬性值不一定會提供相依性屬性中繼資料中指定的預設值。 清除值只會特別清除任何可能已套用的本機值。 如需詳細資訊，請參閱相依性屬性值優先順序。

另請參閱

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey