DependencyObject.GetLocalValueEnumerator Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özel bir numaralandırıcı oluşturur.

public:
 System::Windows::LocalValueEnumerator GetLocalValueEnumerator();

public System.Windows.LocalValueEnumerator GetLocalValueEnumerator();

member this.GetLocalValueEnumerator : unit -> System.Windows.LocalValueEnumerator

Public Function GetLocalValueEnumerator () As LocalValueEnumerator

Döndürülenler

LocalValueEnumerator

Özelleştirilmiş bir yerel değer numaralandırıcısı.

Örnekler

Aşağıdaki örnek, bir nesnede yerel değerleri ayarlanmış tüm özellikleri yineler ve ardından bu tür her özelliğin değerlerini temizlemek için çağrı ClearValue yapar.

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

Açıklamalar

Yerel değer, özellik sisteminin diğer yönlerinden farklı olarak tarafından SetValueayarlanan herhangi bir bağımlılık özellik değeridir.

LocalValueEnumerator çağrısıyla GetLocalValueEnumerator elde edilen, bir örnekte yerel olarak ayarlanmış bir değere DependencyObject sahip olan özellikleri listelemek için kullanılabilir. Bu tür her özellik, belirli LocalValueEntry ve değerlerine başvuran özelliklere sahip bir DependencyProperty nesne tarafından numaralandırıcıda temsil edilir. Yerel olarak ayarlanan değerler üzerinde numaralandırma yapma tekniği, en iyi duruma getirme veya temizlendiğinde hangi özellik değerlerinin değişeceğini belirlemek gibi yerel değerlerin DependencyObject işlenmesi için kullanılabilir.

Important

Döndürülen LocalValueEnumerator , salt okunur olan bağımlılık özelliklerinin kayıtlarını veya değerlerin özellik sistemi tarafından hesaplandığı bağımlılık özelliklerini içerebilir LocalValueEntry . Örneğin, düzen aracılığıyla belirlenmiş bir genişliğe sahip bir görsel çerçeve öğesi için ActualWidthyerel bir değer bildirir. Sıfırlamak için yerel değerler alıyorsanız, söz konusu değerin ReadOnly salt okunur olmadığını doğrulamak LocalValueEntry için her DependencyProperty birinin özellik tanımlayıcısı üzerindeki değeri denetleyin.

Ayrıca bkz.

• LocalValueEntry