ConcurrentStack<T>.TryPopRange Metodo

Definizione

Spazio dei nomi:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Overload

TryPopRange(T[], Int32, Int32)	Tenta di estrarre e restituire più oggetti dall'inizio di ConcurrentStack<T> in modo atomico.
TryPopRange(T[])	Tenta di estrarre e restituire più oggetti dall'inizio di ConcurrentStack<T> in modo atomico.

TryPopRange(T[], Int32, Int32)

Origine:

ConcurrentStack.cs

Tenta di estrarre e restituire più oggetti dall'inizio di ConcurrentStack<T> in modo atomico.

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

Parametri

items

T[]

Array a cui verranno aggiunti gli oggetti estratti dall'inizio di ConcurrentStack<T>.

startIndex

Int32

Offset in base zero in items in corrispondenza del quale iniziare l'inserimento di elementi dall'inizio di ConcurrentStack<T>.

count

Int32

Numero di elementi da estrarre dall'inizio di ConcurrentStack<T> e inserire in items.

Restituisce

Int32

Numero di oggetti estratti correttamente dall'inizio dello stack e inseriti in items.

Eccezioni

ArgumentNullException

items è un riferimento null (Nothing in Visual Basic).

ArgumentOutOfRangeException

startIndex o count è negativo. Oppure startIndex è maggiore o uguale alla lunghezza di items.

ArgumentException

startIndex + count è maggiore della lunghezza di items.

Commenti

Quando si estraono più elementi, se nello stack è presente una contesa, l'uso di TryPopRange può essere più efficiente rispetto all'uso TryPop di una volta per elemento da rimuovere. I nodi riempiono la items matrice con il primo elemento da estrarre all'inizioIndex, il secondo elemento da estrarre all'inizioIndex + 1 e così via.

Vedi anche

• Raccolte thread-safe

TryPopRange(T[])

Origine:

ConcurrentStack.cs

Tenta di estrarre e restituire più oggetti dall'inizio di ConcurrentStack<T> in modo atomico.

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

Parametri

items

T[]

Array a cui verranno aggiunti gli oggetti estratti dall'inizio di ConcurrentStack<T>.

Restituisce

Int32

Numero di oggetti estratti correttamente dall'inizio di ConcurrentStack<T> e inseriti in items.

Eccezioni

ArgumentNullException

items è un argomento Null (Nothing in Visual Basic).

Commenti

Quando si estraono più elementi, se nello stack è presente una contesa, l'uso di può essere più efficiente rispetto all'uso TryPopRangeTryPop di una volta per elemento da rimuovere. I nodi riempiono la items matrice con il primo elemento da estrarre all'inizioIndex, il secondo elemento da estrarre all'inizioIndex + 1 e così via.

Per un esempio di codice, vedere ConcurrentStack<T>.

Vedi anche

• Raccolte thread-safe