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 は、プロパティ システム操作の読み取り専用の依存関係プロパティを識別します。 読み取り専用の依存関係プロパティを定義するクラスでは、このキーをパブリック アクセスで公開しないでください。 公開されているキーは、プロパティの読み取り専用文字を否定する公開コード パスを提供します(クラスやSetValueアセンブリの外部でClearValueメソッドを呼び出したり、キーを参照したりする可能性がある場合)。

呼び出 ClearValue しによってプロパティ値をクリアしても、依存関係プロパティのメタデータで指定されている既定値が必ずしも与えられるわけではありません。 値をクリアすると、適用されたローカル値のみが明確にクリアされます。 詳細については、「依存関係プロパティ値の優先順位」を参照してください。

こちらもご覧ください

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey