ConcurrentStack<T>.PushRange Methode

Definition

Namespace:

System.Collections.Concurrent

Assembly:

System.Collections.Concurrent.dll

Überlädt

PushRange(T[])	Fügt mehrere Objekte atomar am Anfang des ConcurrentStack<T> ein.
PushRange(T[], Int32, Int32)	Fügt mehrere Objekte atomar am Anfang des ConcurrentStack<T> ein.

PushRange(T[])

Quelle:

ConcurrentStack.cs

Fügt mehrere Objekte atomar am Anfang des ConcurrentStack<T> ein.

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

public void PushRange (T[] items);

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

Public Sub PushRange (items As T())

Parameter

items

T[]

Die Objekte, die auf dem ConcurrentStack<T> abgelegt werden sollen.

Ausnahmen

ArgumentNullException

items ist ein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Beim Hinzufügen mehrerer Elemente zum Stapel ist die Verwendung von PushRange ein effizienterer Mechanismus als die Gleichzeitige Verwendung Push eines Elements. Darüber hinaus garantiert PushRange, dass alle Elemente atomar hinzugefügt werden, was bedeutet, dass keine anderen Threads Elemente zwischen die elemente einfügen können, die gepusht werden. Elemente mit niedrigeren Indizes im items Array werden vor Elementen an höhere Indizes gepusht.

Ein Codebeispiel finden Sie unter ConcurrentStack<T>.

Weitere Informationen

• Threadsichere Sammlungen

PushRange(T[], Int32, Int32)

Quelle:

ConcurrentStack.cs

Fügt mehrere Objekte atomar am Anfang des ConcurrentStack<T> ein.

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)

Parameter

items

T[]

Die Objekte, die auf dem ConcurrentStack<T> abgelegt werden sollen.

startIndex

Int32

Der nullbasierte Offset in items, bei dem mit dem Einfügen von Elementen am Anfang des ConcurrentStack<T> begonnen werden soll.

count

Int32

Die Anzahl der Elemente, die am Anfang des ConcurrentStack<T> eingefügt werden sollen.

Ausnahmen

ArgumentNullException

items ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentOutOfRangeException

startIndex oder count ist ein negativer Wert. Oder startIndex ist größer oder gleich der Länge von items.

ArgumentException

startIndex + count ist größer als die Länge von items.

Hinweise

Beim Hinzufügen mehrerer Elemente zum Stapel ist die Verwendung von PushRange ein effizienterer Mechanismus als die Gleichzeitige Verwendung Push eines Elements. Darüber hinaus garantiert PushRange, dass alle Elemente atomar hinzugefügt werden, was bedeutet, dass keine anderen Threads Elemente zwischen die elemente einfügen können, die gepusht werden. Elemente mit niedrigeren Indizes im items Array werden vor Elementen an höhere Indizes gepusht.

Ein Codebeispiel finden Sie unter ConcurrentStack<T>.

Weitere Informationen

• Threadsichere Sammlungen