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 개체 참조로 식별되는 지울 종속성 속성입니다.

예외

봉인된 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 을 통해 속성 값을 지우는 것이 종속성 속성 메타데이터에 지정된 기본값을 반드시 제공하는 것은 아닙니다. 속성을 지우면 적용된 로컬 값만 구체적으로 지워지게 됩니다. 자세한 내용은 종속성 속성 값 우선 순위를 참조하세요.

추가 정보

적용 대상

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

지울 종속성 속성의 키입니다.

예외

봉인된 DependencyObject에서 ClearValue(DependencyProperty)를 호출하려고 시도했습니다.

설명

속성 DependencyPropertyKey 시스템 작업에 대한 읽기 전용 종속성 속성을 식별합니다. 읽기 전용 종속성 속성을 정의하는 클래스는 공용 액세스 권한이 있는 이 키를 노출해서는 안 됩니다. 공개적으로 노출된 키는 속성을 참조하는 클래스 또는 어셈블리 외부에서 메서드를 호출하거나 SetValue 호출할 수 있는 경우 ClearValue 속성의 읽기 전용 문자를 부정하는 공용 코드 경로를 제공합니다.

호출 ClearValue 을 통해 속성 값을 지우는 것이 종속성 속성 메타데이터에 지정된 기본값을 반드시 제공하는 것은 아닙니다. 값을 지우면 로컬 값이 적용되었을 수 있는 모든 값만 구체적으로 지워지게 됩니다. 자세한 내용은 종속성 속성 값 우선 순위를 참조하세요.

추가 정보

적용 대상