ContentLinkProviderCollection.GetMany(UInt32, ContentLinkProvider[]) Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Documents

Récupère plusieurs éléments en une seule passe à travers l’itérateur.

public:
 virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <ContentLinkProvider ^> ^ items) = IVector<ContentLinkProvider ^>::GetMany;

uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <ContentLinkProvider const&> & items);

public uint GetMany(uint startIndex, ContentLinkProvider[] items);

function getMany(startIndex, items)

Public Function GetMany (startIndex As UInteger, items As ContentLinkProvider()) As UInteger

Paramètres

startIndex

UInt32

unsigned int

uint32_t

Index à partir duquel commencer la récupération.

items

ContentLinkProvider[]

Fournit la destination du résultat. Dimensionner la taille initiale du tableau en tant que « capacité » afin de spécifier le nombre de résultats à récupérer.

Retours

UInt32

unsigned int

uint32_t

Le nombre d'éléments à récupérer.

Implémente

M:Windows.Foundation.Collections.IVector1.GetMany(System.UInt32,0[]) M:Windows.Foundation.Collections.IVector1.GetMany(unsigned int,0[]) M:Windows.Foundation.Collections.IVector1.GetMany(uint32_t,0[])

Remarques

Important

Cette API prend en charge les liens de contenu. Les fonctionnalités Windows qui autorisent les liens de contenu ne sont pas disponibles dans les versions de Windows postérieures à Windows 10 version 1903. Les liens de contenu pour les contrôles de texte XAML ne fonctionnent pas dans les versions de Windows ultérieures à la version 1903.

La méthode GetMany fonctionne de la même façon que si vous appelez et pour chaque élément du tableau fourni. Cela signifie que le premier élément retourné par la méthode GetMany est le même élément que celui retourné en récupérant la propriété avant d’appeler GetMany. Une fois l’appel GetMany retourné, la propriété récupère l’élément suivant le dernier élément retourné par l’appel GetMany, ou génère une erreur si plus aucun élément n’existe dans les séquences.

La méthode GetMany retourne le nombre réel d’éléments retournés. Il doit s’agir du minimum de a) du nombre d’éléments restants dans la collection, ou b) du nombre d’éléments demandés, c’est-à-dire « capacité ». Par conséquent, chaque fois que GetMany retourne moins que le nombre d’éléments demandés, la fin de la séquence a été atteinte. Elle retourne le nombre d’éléments récupérés dans le paramètre de sortie « réel ».

Lorsque l’appelant spécifie une capacité de zéro, la position de l’itérateur est inchangée. Les éléments du tableau qui suivent les valeurs retournées sont inchangés.