Queue Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Objektumok első, első előtti gyűjteményét jelöli.
public ref class Queue : System::Collections::ICollection
public ref class Queue : ICloneable, System::Collections::ICollection
public class Queue : System.Collections.ICollection
public class Queue : ICloneable, System.Collections.ICollection
[System.Serializable]
public class Queue : ICloneable, System.Collections.ICollection
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Queue : ICloneable, System.Collections.ICollection
type Queue = class
interface ICollection
interface IEnumerable
type Queue = class
interface ICollection
interface IEnumerable
interface ICloneable
[<System.Serializable>]
type Queue = class
interface ICollection
interface IEnumerable
interface ICloneable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Queue = class
interface ICollection
interface IEnumerable
interface ICloneable
Public Class Queue
Implements ICollection
Public Class Queue
Implements ICloneable, ICollection
- Öröklődés
-
Queue
- Attribútumok
- Megvalósítás
Példák
Az alábbi példa bemutatja, hogyan hozhat létre és adhat hozzá értékeket egy Queue adott fájlhoz, és hogyan nyomtathatja ki az értékeit.
using System;
using System.Collections;
public class SamplesQueue {
public static void Main() {
// Creates and initializes a new Queue.
Queue myQ = new Queue();
myQ.Enqueue("Hello");
myQ.Enqueue("World");
myQ.Enqueue("!");
// Displays the properties and values of the Queue.
Console.WriteLine( "myQ" );
Console.WriteLine( "\tCount: {0}", myQ.Count );
Console.Write( "\tValues:" );
PrintValues( myQ );
}
public static void PrintValues( IEnumerable myCollection ) {
foreach ( Object obj in myCollection )
Console.Write( " {0}", obj );
Console.WriteLine();
}
}
/*
This code produces the following output.
myQ
Count: 3
Values: Hello World !
*/
Imports System.Collections
Public Class SamplesQueue
Public Shared Sub Main()
' Creates and initializes a new Queue.
Dim myQ As New Queue()
myQ.Enqueue("Hello")
myQ.Enqueue("World")
myQ.Enqueue("!")
' Displays the properties and values of the Queue.
Console.WriteLine("myQ")
Console.WriteLine(" Count: {0}", myQ.Count)
Console.Write(" Values:")
PrintValues(myQ)
End Sub
Public Shared Sub PrintValues(myCollection As IEnumerable)
Dim obj As [Object]
For Each obj In myCollection
Console.Write(" {0}", obj)
Next obj
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' myQ
' Count: 3
' Values: Hello World !
Megjegyzések
Ez az osztály körkörös tömbként implementál egy üzenetsort. A rendszer az egyik Queue végén beszúrja a fájlban tárolt objektumokat, és eltávolítja őket a másikból.
Important
Nem javasoljuk, hogy az osztályt Queue új fejlesztéshez használja. Ehelyett azt javasoljuk, hogy az általános Queue<T> osztályt használja. További információ: Non-generic gyűjtemények nem használhatók GitHub.
Az üzenetsorok és a veremek akkor hasznosak, ha ideiglenes tárolóra van szüksége az információkhoz; vagyis amikor érdemes lehet elvetni egy elemet az érték beolvasása után. Akkor használja Queue , ha az adatokat a gyűjteményben tárolt sorrendben kell elérnie. Használja Stack , ha fordított sorrendben kell hozzáférnie az információkhoz. Használja ConcurrentQueue<T> vagy ConcurrentStack<T> ha egyszerre több szálból kell elérnie a gyűjteményt.
Három fő művelet hajtható végre egy Queue és annak elemein:
Peek a legrégebbi elemet adja vissza, amely a fájl elején Queue található, de nem távolítja el a Queue.
Egy adott elem kapacitása Queue a visszatartható elemek Queue száma. Az elemek hozzáadásakor Queuea kapacitás a szükséges módon automatikusan növekszik az újraelosztással. A kapacitás a hívással TrimToSizecsökkenthető.
A növekedési tényező az a szám, amellyel a jelenlegi kapacitás megszorozódik, ha nagyobb kapacitásra van szükség. A növekedési tényezőt a Queue felépítéskor határozzuk meg. Az alapértelmezett növekedési tényező a 2,0. A kapacitás a Queue növekedési tényezőtől függetlenül mindig legalább négy fővel nő. Egy Queue 1,0-s növekedési tényező például mindig négytel növeli a kapacitást, ha nagyobb kapacitásra van szükség.
Queue
null érvényes értékként fogadja el, és lehetővé teszi az ismétlődő elemek használatát.
A gyűjtemény általános verziójával kapcsolatban lásd: System.Collections.Generic.Queue<T>
Konstruktorok
| Név | Description |
|---|---|
| Queue() |
Inicializálja az Queue üres osztály új példányát, az alapértelmezett kezdeti kapacitással rendelkezik, és az alapértelmezett növekedési tényezőt használja. |
| Queue(ICollection) |
Inicializálja az Queue osztály új példányát, amely a megadott gyűjteményből másolt elemeket tartalmaz, a kezdeti kapacitása megegyezik a másolt elemek számával, és az alapértelmezett növekedési tényezőt használja. |
| Queue(Int32, Single) |
Inicializálja az Queue üres osztály új példányát, rendelkezik a megadott kezdeti kapacitással, és a megadott növekedési tényezőt használja. |
| Queue(Int32) |
Inicializálja az Queue üres osztály új példányát, rendelkezik a megadott kezdeti kapacitással, és az alapértelmezett növekedési tényezőt használja. |
Tulajdonságok
| Név | Description |
|---|---|
| Count |
Lekéri a .Queue |
| IsSynchronized |
Beolvas egy értéket, amely jelzi, hogy a Queue hozzáférés szinkronizálva van-e (a szál biztonságos). |
| SyncRoot |
Lekéri az objektumot, amely a hozzáférés szinkronizálására használható.Queue |
Metódusok
| Név | Description |
|---|---|
| Clear() |
Eltávolítja az összes objektumot a Queue. |
| Clone() |
Létrehoz egy sekély másolatot a Queue. |
| Contains(Object) |
Meghatározza, hogy egy elem szerepel-e a Queue. |
| CopyTo(Array, Int32) |
Az elemeket egy meglévő egydimenziósra Queuemásolja Array a megadott tömbindextől kezdve. |
| Dequeue() |
Eltávolítja és visszaadja az objektumot a Queuefájl elején. |
| Enqueue(Object) |
Objektumot ad hozzá a Queuevégéhez. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetEnumerator() |
Egy enumerátort ad vissza, amely a Queue. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| Peek() |
Az objektumot az objektum eltávolítása nélkül adja vissza a Queue fájl elején. |
| Synchronized(Queue) |
Egy újat Queue ad vissza, amely az eredeti üzenetsort burkolja, és a szál biztonságos. |
| ToArray() |
Másolja az Queue elemeket egy új tömbbe. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
| TrimToSize() |
A kapacitást a tényleges számú elemre állítja be a Queue. |
Bővítő metódusok
| Név | Description |
|---|---|
| AsParallel(IEnumerable) |
Lehetővé teszi a lekérdezés párhuzamosítását. |
| AsQueryable(IEnumerable) |
Átalakítja az egyiket IEnumerableIQueryable. |
| Cast<TResult>(IEnumerable) |
Egy elem elemeit IEnumerable a megadott típusra veti. |
| OfType<TResult>(IEnumerable) |
Egy adott típus alapján szűri IEnumerable egy adott elem elemeit. |
A következőre érvényes:
Szálbiztonság
A nyilvános statikus (Shared Visual Basic) ilyen típusú tagjai szálbiztosak. A példánytagok nem garantáltan szálbiztosak.
A menetbiztonság garantálása Queueérdekében minden műveletet a metódus által Synchronized(Queue) visszaadott burkolón keresztül kell elvégezni.
A gyűjteményen keresztüli számbavétel alapvetően nem szálbiztos eljárás. A gyűjtemény szinkronizálása esetén is más szálak módosíthatják a gyűjteményt, ami miatt az enumerátor kivételt okoz. Az enumerálás során a szálbiztonság garantálása érdekében zárolhatja a gyűjteményt a teljes enumerálás során, vagy elkaphatja a más szálak által végrehajtott módosításokból eredő kivételeket.