ConcurrentStack<T>.TryPopRange Méthode

Définition

Espace de noms:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Surcharges

TryPopRange(T[], Int32, Int32)	Tente de dépiler et retourner atomiquement plusieurs objets du haut de ConcurrentStack<T>.
TryPopRange(T[])	Tente de dépiler et retourner atomiquement plusieurs objets du haut de ConcurrentStack<T>.

TryPopRange(T[], Int32, Int32)

Source:

ConcurrentStack.cs

Tente de dépiler et retourner atomiquement plusieurs objets du haut de ConcurrentStack<T>.

public:
 int TryPopRange(cli::array <T> ^ items, int startIndex, int count);

public int TryPopRange (T[] items, int startIndex, int count);

member this.TryPopRange : 'T[] * int * int -> int

Public Function TryPopRange (items As T(), startIndex As Integer, count As Integer) As Integer

Paramètres

items

T[]

Array auquel les objets dépilés en partant du haut de ConcurrentStack<T> seront ajoutés.

startIndex

Int32

Offset basé sur zéro dans items à partir duquel commencer l'insertion des éléments en partant du haut de ConcurrentStack<T>.

count

Int32

Nombre d'éléments à dépiler en partant du haut de ConcurrentStack<T> et à insérer dans items.

Retours

Int32

Nombre d'objets correctement dépilés en partant du haut de la pile et insérés dans items.

Exceptions

ArgumentNullException

items est une référence Null (Nothing en Visual Basic).

ArgumentOutOfRangeException

startIndex ou count est un nombre négatif. Ou le paramètre startIndex est supérieur ou égal à la longueur de items.

ArgumentException

startIndex + count est supérieur à la longueur de items.

Remarques

Lors de l’extraction de plusieurs éléments, s’il y a peu de contention sur la pile, l’utilisation de TryPopRange peut être plus efficace que d’utiliser TryPop une seule fois par élément à supprimer. Les nœuds remplissent le items tableau avec le premier élément à faire apparaître dans startIndex, le deuxième élément à faire apparaître à startIndex + 1, et ainsi de suite.

Voir aussi

• Collections thread-safe

TryPopRange(T[])

Source:

ConcurrentStack.cs

Tente de dépiler et retourner atomiquement plusieurs objets du haut de ConcurrentStack<T>.

public:
 int TryPopRange(cli::array <T> ^ items);

public int TryPopRange (T[] items);

member this.TryPopRange : 'T[] -> int

Public Function TryPopRange (items As T()) As Integer

Paramètres

items

T[]

Array auquel les objets dépilés en partant du haut de ConcurrentStack<T> seront ajoutés.

Retours

Int32

Nombre d'objets correctement dépilés en partant du haut de ConcurrentStack<T> et insérés dans items.

Exceptions

ArgumentNullException

items est un argument null (Nothing en Visual Basic).

Remarques

Lors de l’extraction de plusieurs éléments, s’il y a peu de contention sur la pile, l’utilisation TryPopRange peut être plus efficace que l’utilisation TryPop d’une seule fois par élément à supprimer. Les nœuds remplissent le items tableau avec le premier élément à faire apparaître dans startIndex, le deuxième élément à faire apparaître à startIndex + 1, et ainsi de suite.

Pour obtenir un exemple de code, consultez ConcurrentStack<T>.

Voir aussi

• Collections thread-safe