DependencyObject.ClearValue Metódus

Definíció

Névtér:

System.Windows

Szerelvény:

WindowsBase.dll

Törli egy tulajdonság helyi értékét.

Túlterhelések

Name	Description
ClearValue(DependencyProperty)	Törli egy tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyProperty azonosító határozza meg.
ClearValue(DependencyPropertyKey)	Törli egy írásvédett tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyPropertyKey.

ClearValue(DependencyProperty)

Törli egy tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyProperty azonosító határozza meg.

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)

Paraméterek

dp

DependencyProperty

A törölni kívánt függőségi tulajdonság, amelyet egy DependencyProperty objektumhivatkozás azonosít.

Kivételek

InvalidOperationException

Megkísérlődött ClearValue(DependencyProperty) egy lezárt DependencyObjecthívás.

Példák

Az alábbi példa iterálja az összes olyan tulajdonságot, amely helyi értékekkel rendelkezik egy objektumon, majd meghívja ClearValue az egyes tulajdonságok értékeinek törlését.

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

Megjegyzések

A tulajdonság értékének meghívással ClearValue történő törlése nem feltétlenül adja meg a függőségi tulajdonságnak a függőségi tulajdonság metaadataiban megadott alapértelmezett értéket. A tulajdonság törlése csak az alkalmazott helyi értékeket törli. További információ: Dependency Property Value Precedence.

Lásd még

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

Törli egy írásvédett tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy 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)

Paraméterek

key

DependencyPropertyKey

A törölni kívánt függőségi tulajdonság kulcsa.

Kivételek

InvalidOperationException

Megkísérlődött ClearValue(DependencyProperty) egy lezárt DependencyObjecthívás.

Megjegyzések

A DependencyPropertyKey tulajdonságrendszer-műveletek írásvédett függőségi tulajdonságát azonosítja. Az írásvédett függőségi tulajdonságokat meghatározó osztályok nem tehetik közzé ezt a kulcsot nyilvános hozzáféréssel. A nyilvánosan közzétett kulcsok olyan nyilvános kódútvonalakat biztosítanak, amelyek nem jelölik a tulajdonság írásvédett karakterét, ha a metódusok, például ClearValueSetValue az osztályon vagy a szerelvényen kívül is meghívhatók, hivatkozva a kulcsra.

A tulajdonság értékének meghívással ClearValue történő törlése nem feltétlenül adja meg a függőségi tulajdonságnak a függőségi tulajdonság metaadataiban megadott alapértelmezett értéket. Az érték törlése csak konkrétan törli az esetleges helyi értékeket. További információ: Dependency Property Value Precedence.

Lásd még

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey