DependencyObject.GetLocalValueEnumerator Yöntem
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özelleştirilmiş bir numaralandırıcı oluşturur.
public:
System::Windows::LocalValueEnumerator GetLocalValueEnumerator();public System.Windows.LocalValueEnumerator GetLocalValueEnumerator ();member this.GetLocalValueEnumerator : unit -> System.Windows.LocalValueEnumeratorPublic Function GetLocalValueEnumerator () As LocalValueEnumeratorÖzelleştirilmiş bir yerel değer numaralandırıcısı.
Aşağıdaki örnek, bir nesnede yerel değerleri ayarlanmış olan 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
Yerel değer, özellik sisteminin diğer yönlerinden farklı olarak tarafından SetValueayarlanan herhangi bir bağımlılık özelliği değeridir.
LocalValueEnumerator çağrısıyla GetLocalValueEnumerator elde edilen, bir örnekte yerel olarak ayarlanmış bir değere DependencyObject sahip özellikleri listelemek için kullanılabilir. Bu tür her özellik, belirli DependencyProperty ve değerlerine başvuran özelliklere sahip bir LocalValueEntry nesne tarafından numaralandırıcıda temsil edilir. Yerel olarak ayarlanan değerler üzerinde numaralandırma yapma tekniği, iyileştirme için veya yerel değerlerin işlenmesi için kullanılabilir; örneğin, temizlendiklerinde hangi özellik değerlerinin DependencyObject değişeceğini belirlemek için.
Önemli
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ş 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 DependencyProperty için her LocalValueEntry birinin özellik tanımlayıcısında bulunan değeri denetleyin.
| Ürün | Sürümler |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |