DependencyObject.GetLocalValueEnumerator, méthode

Une valeur de proximité est toute valeur de propriété de dépendance définie par SetValue, par opposition à d'autres aspects du système de propriétés.

Le LocalValueEnumerator obtenu en appelant GetLocalValueEnumerator peut être utilisé pour énumérer des propriétés qui ont une valeur définie localement sur une instance DependencyObject. Chacune de ces propriétés est représentée dans l'énumérateur par un objet LocalValueEntry, qui a des propriétés qui référencent les DependencyProperty spécifiques et ses valeurs. Cette technique d'énumération sur les valeurs définies localement peut être utilisée pour l'optimisation ou pour une autre gestion de valeurs de proximité, comme pour déterminer quelles valeurs de propriété d'un DependencyObject changeraient si elles étaient effacées.

Important

Le LocalValueEnumerator retourné peut contenir des enregistrements LocalValueEntry pour les propriétés de dépendance qui sont en lecture seule, ou des propriétés de dépendance où les valeurs sont calculées par le système de propriétés. Par exemple, un élément d'infrastructure visuel qui a une largeur établie à travers la mise en page signalera une valeur de proximité pour ActualWidth. Si vous obtenez des valeurs de proximité pour les réinitialiser, vérifiez la valeur ReadOnly sur l'identificateur de propriété de chaque LocalValueEntry pour vérifier que le DependencyProperty en question n'est pas en lecture seule.

L'exemple suivant itère toutes les propriétés dont l'ensemble de valeurs de proximité est défini sur un objet, puis appelle ClearValue pour effacer les valeurs de chaque propriété de ce type.

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); }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources