DependencyObject.ClearValue メソッド

定義

プロパティのローカル値をクリアします。

オーバーロード

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 オブジェクト参照によって識別される、消去対象の依存関係プロパティ。

例外

シールされている DependencyObjectClearValue(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 メタデータで指定されている既定値に依存関係プロパティが付与されるとは限りません。 プロパティをクリアすると、適用されている可能性があるすべてのローカル値が明示的にクリアされます。 詳細については、「依存関係プロパティ値の優先順位」を参照してください。

こちらもご覧ください

適用対象

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

消去する依存関係プロパティのキー。

例外

シールされている DependencyObjectClearValue(DependencyProperty) を呼び出そうとしました。

注釈

は、 DependencyPropertyKey プロパティシステム操作の読み取り専用の依存関係プロパティを識別します。 読み取り専用の依存関係プロパティを定義するクラスでは、このキーをパブリックアクセスで公開しないでください。 公開されたキーは、またはなどのメソッドが、 ClearValue SetValue キーを参照するクラスまたはアセンブリの外部で呼び出された場合に、プロパティの読み取り専用の文字を否定するパブリックコードのパスを提供します。

を呼び出してプロパティ値をクリアしても、依存関係プロパティの ClearValue メタデータで指定されている既定値に依存関係プロパティが付与されるとは限りません。 値をクリアすると、適用されている可能性があるローカル値のみが明示的にクリアされます。 詳細については、「依存関係プロパティ値の優先順位」を参照してください。

こちらもご覧ください

適用対象