Freigeben über

IVector<T> Schnittstelle

  • Referenz

Definition

Namespace:
Windows.Foundation.Collections
Bearbeiten

Stellt eine Auflistung von Elementen mit zufälligem Zugriff dar.

.NETTO Diese Schnittstelle wird für .NET-Code aufgrund der .NET-Sprachprojektion als System.Collections.Generic.IList<T> angezeigt. In jedem Fall, wenn ein Windows-Runtime-Typ IVector<T> implementiert hat, kann .NET-Code stattdessen die APIs von IList<T> verwenden.

public interface class IVector : IIterable<T>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
template <typename T>
struct IVector : IIterable<T>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
public interface IList<T> : IEnumerable<T>
Public Interface IList(Of T)
Implements IEnumerable(Of T)

Typparameter

T
Attribute
ContractVersionAttribute GuidAttribute
Implementiert
IIterable<T> IEnumerable<T>

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (eingeführt in v1.0)

Hinweise

Beim Programmieren mit .NET ist diese Schnittstelle ausgeblendet, und Entwickler sollten die System.Collections.Generic.IList<T-Schnittstelle> verwenden, wenn sie einen Vektor-/Listentyp implementieren möchten. In jedem Fall, wenn ein Windows-Runtime-Typ IVector<T> implementiert hat, kann .NET-Code stattdessen die APIs von IList<T> verwenden. Dies umfasst alle vorhandenen Windows-Runtime-API sowie Szenarien wie die Verwendung der APIs von Windows-Runtime Komponenten, die ursprünglich in Visual C++-Komponentenerweiterungen (C++/CX) aus einer C#- oder Visual Basic-App implementiert wurden.

Die IVector<T-Schnittstelle> stellt eine Auflistung von Objekten eines angegebenen Typs dar, auf die vom Index einzeln zugegriffen werden kann. Eigenschaften und Methoden von IVector<T> unterstützen Listentypfunktionen, z. B. das Abrufen der Größe der Auflistung und das Hinzufügen und Entfernen von Elementen an angegebenen Speicherorten in der Auflistung. Darüber hinaus stellt die GetView-Methode eine Momentaufnahme des Vektors bereit, dessen beobachtbarer Zustand sich nicht ändert. Die Momentaufnahme ist nützlich, wenn Sie eine Ansicht der Auflistung benötigen, auf die in nachfolgenden Vorgängen verwiesen werden soll, die IVector<T> betreffen.

C++/WinRT-Erweiterungsfunktionen

Hinweis

Erweiterungsfunktionen sind für die C++/WinRT-Projektionstypen für bestimmte Windows-Runtime-APIs vorhanden. Winrt::Windows::Foundation::IAsyncAction ist beispielsweise der C++/WinRT-Projektionstyp für IAsyncAction. Die Erweiterungsfunktionen sind nicht Teil der ABI-Oberfläche (Application Binary Interface) der tatsächlichen Windows-Runtime-Typen, daher werden sie nicht als Member der Windows-Runtime-APIs aufgeführt. Sie können sie jedoch in jedem C++/WinRT-Projekt aufrufen. Weitere Informationen finden Sie unter C++/WinRT-Funktionen, die Windows-Runtime-APIs erweitern.

auto begin() const;

Gibt einen Iterator für das erste Element der Auflistung zur Verwendung in C++-Algorithmen zurück, z. B. bereichsbasierte for Schleifen.

auto end() const;

Gibt einen Iterator nach dem letzten Element der Auflistung für die Verwendung in C++-Algorithmen zurück, z. B. bereichsbasierte for Schleifen.

Schnittstellenvererbung

IVector erbt IIterable. Typen, die IVector implementieren, implementieren auch die Schnittstellenmember von IIterable. Wenn Sie .NET verwenden, wird auch IEnumerable<T> unterstützt.

Eigenschaften

Size

Ruft die Anzahl der Elemente im Vektor ab.

Methoden

Append(T)

Fügt ein Element an das Ende des Vektors an.
Clear()

Entfernt alle Elemente aus dem Vektor.
GetAt(UInt32)

Gibt das Element am angegebenen Index im Vektor zurück.
GetMany(UInt32, T[])

Ruft mehrere Elemente aus dem Vektor ab, die am angegebenen Index beginnen.

C++/WinRT Die richtige Syntax für die C++/WinRT-Sprachprojektion ist uint32_t GetMany(uint32_t startIndex, winrt::array_view<T> items);.
GetView()

Gibt eine unveränderliche Ansicht des Vektors zurück.
IndexOf(T, UInt32)

Ruft den Index eines angegebenen Elements im Vektor ab.
InsertAt(UInt32, T)

Fügt ein Element an einem angegebenen Index im Vektor ein.
RemoveAt(UInt32)

Entfernt das Element am angegebenen Index im Vektor.
RemoveAtEnd()

Entfernt das letzte Element aus dem Vektor.
ReplaceAll(T[])

Ersetzt alle Elemente im Vektor durch die angegebenen Elemente.
SetAt(UInt32, T)

Legt den Wert am angegebenen Index im Vektor fest.

Gilt für:

Weitere Informationen