Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DependencyObject.GetLocalValueEnumerator-Methode: ()

 

Veröffentlicht: Oktober 2016

Erstellt einen spezialisierten Enumerator für die Bestimmung, welche Abhängigkeitseigenschaften lokal auf diesem festgelegte Werte haben DependencyObject.

Namespace:   System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public LocalValueEnumerator GetLocalValueEnumerator()

Rückgabewert

Type: System.Windows.LocalValueEnumerator

Ein spezialisierter lokaler Wertenumerator.

Ein lokalen Wert ist jeder Wert einer Abhängigkeitseigenschaft, die festgelegt wurde, indem SetValue, im Gegensatz zu anderen Aspekte des Eigenschaftensystems.

Die LocalValueEnumerator durch den Aufruf von GetLocalValueEnumerator kann verwendet werden, um die Eigenschaften aufgelistet, die über einem lokal festgelegten Wert auf eine DependencyObject Instanz. Jede dieser Eigenschaften wird im Enumerator durch dargestellt ein LocalValueEntry -Objekt, das Eigenschaften verfügt, die sich auf die spezifischen DependencyProperty und die zugehörigen Werte. Dieses Verfahren für Aufzählen über lokal festgelegten Werte können verwendet werden zur Optimierung oder für andere lokale Werte, z. B. welche Eigenschaftswerte bestimmt ein DependencyObject wird geändert, wenn sie deaktiviert wurden.

System_CAPS_importantWichtig

Das zurückgegebene LocalValueEnumerator enthalten LocalValueEntry Datensätze für schreibgeschützte Abhängigkeitseigenschaften sowie Abhängigkeitseigenschaften, deren Werte vom Eigenschaftensystem berechnet werden. Ein visuelles Element, das einen festgelegten durch Layout Breite meldet z. B. einen lokalen Wert für ActualWidth. Wenn Sie lokale Werte abrufen, um diese zurückzusetzen, überprüfen Sie die ReadOnly Wert der Eigenschaft-ID der einzelnen LocalValueEntry zu überprüfen, ob die DependencyProperty betreffenden nicht schreibgeschützt ist.

Im folgenden Beispiel werden alle Eigenschaften, die lokale Werte festgelegt, die auf ein Objekt, ruft dann ClearValue die Werte dieser Eigenschaften gelöscht.

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
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: