ConcurrentStack<T>.TryPopRange Metodo

Definizione

Spazio dei nomi:
System.Collections.Concurrent
Assembly:
mscorlib.dll, System.Collections.Concurrent.dll
Assembly:
mscorlib.dll
Assembly:
System.Collections.Concurrent.dll
Assembly:
netstandard.dll

Overload

Nome Descrizione
TryPopRange(T[], Int32, Int32)

Tenta di visualizzare e restituire più oggetti dalla parte superiore dell'oggetto ConcurrentStack<T> atomicamente.
TryPopRange(T[])

Tenta di visualizzare e restituire più oggetti dalla parte superiore dell'oggetto ConcurrentStack<T> atomicamente.

TryPopRange(T[], Int32, Int32)

Tenta di visualizzare e restituire più oggetti dalla parte superiore dell'oggetto ConcurrentStack<T> atomicamente.

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[]

Oggetto Array a cui verranno aggiunti gli oggetti che estraevano dalla parte superiore di ConcurrentStack<T> .

startIndex
Int32

Offset in base zero in in items in corrispondenza del quale iniziare l'inserimento di elementi dalla parte superiore di ConcurrentStack<T>.

count
Int32

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

Valori restituiti

Int32

Numero di oggetti restituiti correttamente dalla parte superiore 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 estrae più elementi, se è presente una contesa nello stack, l'uso di TryPopRange può essere più efficiente rispetto all'uso TryPop di una sola 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

Si applica a

TryPopRange(T[])

Tenta di visualizzare e restituire più oggetti dalla parte superiore dell'oggetto ConcurrentStack<T> atomicamente.

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[]

Oggetto Array a cui verranno aggiunti gli oggetti che estraevano dalla parte superiore di ConcurrentStack<T> .

Valori restituiti

Int32

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

Eccezioni

ArgumentNullException

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

Commenti

Quando si estrae più elementi, se è presente una contesa nello stack, l'uso 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.

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

Vedi anche

Si applica a