Partage via


IVector<T> Interface

Définition

Représente une collection d’éléments à accès aléatoire.

.NET Cette interface apparaît au code .NET sous la forme System.Collections.Generic.IList<T> en raison de la projection du langage .NET. Dans tous les cas où un type Windows Runtime a implémenté IVector<T>, le code .NET peut utiliser les API d’IList<T> à la place.

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)

Paramètres de type

T
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduit dans v1.0)

Remarques

Lors de la programmation avec .NET, cette interface est masquée et les développeurs doivent utiliser l’interface T> System.Collections.Generic.IList< s’ils veulent implémenter un type vector/list. Dans tous les cas où un type Windows Runtime a implémenté IVector<T>, le code .NET peut utiliser les API d’IList<T> à la place. Cela inclut toutes les API Windows Runtime existantes, ainsi que des scénarios tels que l’utilisation des API de Windows Runtime composants implémentés à l’origine dans les extensions de composants Visual C++ (C++/CX) à partir d’une application C# ou Visual Basic.

L’interface IVector<T> représente une collection d’objets d’un type spécifié qui peuvent être consultés individuellement par index. Les propriétés et méthodes d’IVector<T> prennent en charge les fonctionnalités de type liste, telles que l’obtention de la taille de la collection et l’ajout et la suppression d’éléments à des emplacements spécifiés dans la collection. En outre, la méthode GetView fournit une instantané du vecteur dont l’état observable ne change pas. Le instantané est utile lorsque vous avez besoin d’une vue de la collection à laquelle faire référence dans les opérations suivantes qui impliquent IVector<T>.

Fonctions d’extension C++/WinRT

Notes

Des fonctions d’extension existent sur les types de projection C++/WinRT pour certaines API Windows Runtime. Par exemple, winrt ::Windows ::Foundation ::IAsyncAction est le type de projection C++/WinRT pour IAsyncAction. Les fonctions d’extension ne font pas partie de la surface d’interface binaire d’application (ABI) des types Windows Runtime réels. Elles ne sont donc pas répertoriées en tant que membres des API Windows Runtime. Mais vous pouvez les appeler à partir de n’importe quel projet C++/WinRT. Consultez Fonctions C++/WinRT qui étendent Windows Runtime API.

auto begin() const;

Retourne un itérateur au premier élément de la collection, à utiliser dans des algorithmes C++, tels que des boucles basées sur for une plage.

auto end() const;

Retourne un itérateur à un passé du dernier élément de la collection, à utiliser dans des algorithmes C++ tels que des boucles basées sur for une plage.

Héritage de l'interface

IVector hérite d’IIterable. Les types qui implémentent IVector implémentent également les membres d’interface d’IIterable. De même, si vous utilisez .NET, il existe une prise en charge de IEnumerable<T>.

Propriétés

Size

Obtient le nombre d’éléments dans le vecteur.

Méthodes

Append(T)

Ajoute un élément à la fin du vecteur.

Clear()

Supprime tous les éléments du vecteur.

GetAt(UInt32)

Retourne l’élément à l’index spécifié dans le vecteur.

GetMany(UInt32, T[])

Récupère plusieurs éléments du vecteur commençant à l’index donné.

C++/WinRT La syntaxe correcte pour la projection de langage C++/WinRT est uint32_t GetMany(uint32_t startIndex, winrt::array_view<T> items);.

GetView()

Retourne une vue immuable du vecteur.

IndexOf(T, UInt32)

Récupère l’index d’un élément spécifié dans le vecteur.

InsertAt(UInt32, T)

Insère un élément à un index spécifié dans le vecteur.

RemoveAt(UInt32)

Supprime l’élément à l’index spécifié dans le vecteur.

RemoveAtEnd()

Supprime le dernier élément du vecteur.

ReplaceAll(T[])

Remplace tous les éléments du vecteur par les éléments spécifiés.

SetAt(UInt32, T)

Définit la valeur à l’index spécifié dans le vecteur.

S’applique à

Voir aussi