DependencyObjectCollection Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Implementiert eine praktische Auflistungsklasse, die DependencyObject-Elemente enthalten kann.
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyObjectCollection : DependencyObject, IIterable<DependencyObject>, IObservableVector<DependencyObject>, IVector<DependencyObject>[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DependencyObjectCollection : DependencyObject, IEnumerable<DependencyObject>, IList<DependencyObject>, IObservableVector<DependencyObject>Public Class DependencyObjectCollection
Inherits DependencyObject
Implements IEnumerable(Of DependencyObject), IList(Of DependencyObject), IObservableVector(Of DependencyObject)- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
Der Zweck der DependencyObjectCollection-Klasse besteht hauptsächlich darin, die Tools und die Portabilität von Verhaltensweisen zu unterstützen. Verhaltensweisen sind eine Technik zum Definieren bestimmter grundlegender Interaktionen eines UI-Elements vollständig in XAML, ohne dass ein Ereignishandler und CodeBehind erforderlich sind.
Wenn Sie daran interessiert sind, eine Geschäftsobjektklasse zu implementieren, die Benachrichtigungen über Sammlungsänderungen unterstützt, sollten Sie ObservableCollection oder eines der Schnittstellenmuster verwenden, das geänderte Ereignisse unterstützt. Weitere Informationen finden Sie unter Datenbindung im Detail.
Auflisten der Sammlung in C# oder Microsoft Visual Basic
Eine DependencyObjectCollection ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<DependencyObject> umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer DependencyObject-Einschränkung in IEnumerable<T> um.
Konstruktoren
| DependencyObjectCollection() |
Initialisiert eine neue instance der DependencyObjectCollection-Klasse. |
Eigenschaften
| Dispatcher |
Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject) |
| Size |
Ruft die Größe (Anzahl) der Auflistung ab. |
Methoden
| Append(DependencyObject) |
Fügt der Auflistung ein neues Element hinzu. |
| Clear() |
Entfernt alle Elemente aus der Auflistung. |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| First() |
Gibt den Iterator für die Iteration über die Elemente in der Auflistung zurück. |
| GetAnimationBaseValue(DependencyProperty) |
Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, der in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject) |
| GetAt(UInt32) |
Gibt das DependencyObject zurück, das sich am angegebenen Index befindet. |
| GetMany(UInt32, DependencyObject[]) |
Ruft mehrere Elemente in einem einzigen Durchlauf durch den Iterator ab. |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
| GetView() |
Ruft eine unveränderliche Ansicht in die Auflistung ab. |
| IndexOf(DependencyObject, UInt32) |
Ruft den Index des angegebenen Elements ab. |
| InsertAt(UInt32, DependencyObject) |
Fügt das angegebene Element am angegebenen Index ein. |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject) |
| RemoveAt(UInt32) |
Entfernt das Element am angegebenen Index. |
| RemoveAtEnd() |
Entfernt das letzte Element in der Auflistung. |
| ReplaceAll(DependencyObject[]) |
Löscht zunächst die Auflistung und fügt dann das bereitgestellte Array als neue Elemente ein. |
| SetAt(UInt32, DependencyObject) |
Legt den Wert am angegebenen Index auf den angegebenen DependencyObject-Wert fest. |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
| VectorChanged |
Tritt auf, wenn sich der Inhalt der Auflistung ändert. |