Nyelv

Queue Osztály

Definíció

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:

  • Enqueue A a végéhez Queuehozzáad egy elemet.

  • Dequeue eltávolítja a legrégebbi elemet a Queue.

  • 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.

Lásd még