ConcurrentStack<T>.PushRange Metoda

Definice

Obor názvů:

System.Collections.Concurrent

Sestavení:

System.Collections.Concurrent.dll

Přetížení

PushRange(T[])	Vloží více objektů v horní části objektu ConcurrentStack<T> atomicky.
PushRange(T[], Int32, Int32)	Vloží více objektů v horní části objektu ConcurrentStack<T> atomicky.

PushRange(T[])

Zdroj:

ConcurrentStack.cs

Vloží více objektů v horní části objektu ConcurrentStack<T> atomicky.

public:
 void PushRange(cli::array <T> ^ items);

public void PushRange (T[] items);

member this.PushRange : 'T[] -> unit

Public Sub PushRange (items As T())

Parametry

items

T[]

Objekty, které se mají zasunout na ConcurrentStack<T>.

Výjimky

ArgumentNullException

items je odkaz s hodnotou null (Nothing v jazyce Visual Basic).

Poznámky

Při přidávání více položek do zásobníku je použití PushRange efektivnější mechanismus než použití Push jedné položky najednou. PushRange navíc zaručuje, že všechny elementy budou přidány atomicky, což znamená, že žádná jiná vlákna nebudou moci vložit elementy mezi vložené prvky. Položky s nižšími indexy v items poli budou vloženy před položky s vyššími indexy.

Příklad kódu najdete v tématu ConcurrentStack<T>.

Viz také

• Kolekce bezpečné pro přístup z více vláken

PushRange(T[], Int32, Int32)

Zdroj:

ConcurrentStack.cs

Vloží více objektů v horní části objektu ConcurrentStack<T> atomicky.

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

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

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

Public Sub PushRange (items As T(), startIndex As Integer, count As Integer)

Parametry

items

T[]

Objekty, které se mají zasunout na ConcurrentStack<T>.

startIndex

Int32

Posun založený na nule, při items kterém se mají začít vkládat prvky do horní části objektu ConcurrentStack<T>.

count

Int32

Počet prvků, které mají být vloženy do horní části objektu ConcurrentStack<T>.

Výjimky

ArgumentNullException

items je odkaz s hodnotou null (Nothing v jazyce Visual Basic).

ArgumentOutOfRangeException

startIndex nebo count je negativní. Nebo startIndex je větší nebo rovna délce .items

ArgumentException

startIndex + countje větší než délka .items

Poznámky

Při přidávání více položek do zásobníku je použití PushRange efektivnější mechanismus než použití Push jedné položky najednou. PushRange navíc zaručuje, že všechny elementy budou přidány atomicky, což znamená, že žádná jiná vlákna nebudou moci vložit elementy mezi vložené prvky. Položky s nižšími indexy v items poli budou vloženy před položky s vyššími indexy.

Příklad kódu najdete v tématu ConcurrentStack<T>.

Viz také

• Kolekce bezpečné pro přístup z více vláken