Esporta (0) Stampa
Espandi tutto

Stack (classe generica)

Rappresenta un insieme LIFO (last-in-first-out) di dimensioni variabili costituito da istanze dello stesso tipo arbitrario.

Spazio dei nomi: System.Collections.Generic
Assembly: System (in system.dll)

[SerializableAttribute] 
[ComVisibleAttribute(false)] 
public class Stack<T> : IEnumerable<T>, ICollection, 
	IEnumerable
J# supporta l'utilizzo di tipi e metodi generici ma non la dichiarazione di nuovi.
JScript non supporta tipi e metodi generici.
Non applicabile.

Parametri di tipo

T

Specifica il tipo di elementi nello stack.

L'oggetto Stack è implementato come matrice.

La capacità di una classe Stack è il numero di elementi che tale classe Stack può contenere. Ogni volta che si aggiungono elementi a una classe Stack, la capacità viene automaticamente aumentata nel modo appropriato riallocando la matrice interna. La capacità può essere ridotta mediante la chiamata a TrimExcess.

Se Count è minore della capacità dello stack, Push rappresenta un'operazione O(1). Se la capacità deve essere incrementata per far posto al nuovo elemento, Push diventa un'operazione O(n), dove n è Count. Pop è un'operazione O(1).

Stack accetta riferimento null (Nothing in Visual Basic) come valore valido per i tipi di riferimento e consente elementi duplicati.

Nell'esempio di codice riportato di seguito vengono illustrati diversi metodi della classe generica Stack. Viene creato uno stack di stringhe con la capacità predefinita e viene utilizzato il metodo Push per eseguire il push di cinque stringhe nello stack. Gli elementi dello stack vengono enumerati, senza alcun effetto sullo stato dello stack. Viene utilizzato il metodo Pop per estrarre la prima stringa dallo stack. Viene utilizzato il metodo Peek per esaminare il successivo elemento dello stack, quindi viene utilizzato il metodo Pop per estrarlo.

Viene utilizzato il metodo ToArray per creare una matrice e copiarvi gli elementi dello stack, quindi la matrice viene passata al costruttore Stack che accetta IEnumerable, creando una copia dello stack con gli elementi in ordine inverso. Vengono visualizzati gli elementi della copia.

Viene creata una matrice di dimensioni doppie rispetto allo stack, quindi viene utilizzato il metodo CopyTo per copiare gli elementi della matrice a partire dal centro della matrice. Viene utilizzato di nuovo il costruttore Stack per creare una copia dello stack con gli elementi in ordine inverso, quindi i tre elementi null si trovano alla fine.

Viene utilizzato il metodo Contains per mostrare che la stringa "four" è nella prima copia dello stack, quindi il metodo Clear cancella il contenuto della copia e infine la proprietà Count mostra che lo stack è vuoto.

using System;
using System.Collections.Generic;

class Example
{
    public static void Main()
    {
        Stack<string> numbers = new Stack<string>();
        numbers.Push("one");
        numbers.Push("two");
        numbers.Push("three");
        numbers.Push("four");
        numbers.Push("five");

        // A stack can be enumerated without disturbing its contents.
        foreach( string number in numbers )
        {
            Console.WriteLine(number);
        }

        Console.WriteLine("\nPopping '{0}'", numbers.Pop());
        Console.WriteLine("Peek at next item to destack: {0}", 
            numbers.Peek());
        Console.WriteLine("Popping '{0}'", numbers.Pop());

        // Create a copy of the stack, using the ToArray method and the
        // constructor that accepts an IEnumerable<T>.
        Stack<string> stack2 = new Stack<string>(numbers.ToArray());

        Console.WriteLine("\nContents of the first copy:");
        foreach( string number in stack2 )
        {
            Console.WriteLine(number);
        }
        
        // Create an array twice the size of the stack and copy the
        // elements of the stack, starting at the middle of the 
        // array. 
        string[] array2 = new string[numbers.Count * 2];
        numbers.CopyTo(array2, numbers.Count);
        
        // Create a second stack, using the constructor that accepts an
        // IEnumerable(Of T).
        Stack<string> stack3 = new Stack<string>(array2);

        Console.WriteLine("\nContents of the second copy, with duplicates and nulls:");
        foreach( string number in stack3 )
        {
            Console.WriteLine(number);
        }

        Console.WriteLine("\nstack2.Contains(\"four\") = {0}", 
            stack2.Contains("four"));

        Console.WriteLine("\nstack2.Clear()");
        stack2.Clear();
        Console.WriteLine("\nstack2.Count = {0}", stack2.Count);
    }
}

/* This code example produces the following output:

five
four
three
two
one

Popping 'five'
Peek at next item to destack: four
Popping 'four'

Contents of the first copy:
one
two
three

Contents of the second copy, with duplicates and nulls:
one
two
three




stack2.Contains("four") = False

stack2.Clear()

stack2.Count = 0
 */

System.Object
  System.Collections.Generic.Stack

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. Qualsiasi membro di istanza non ha garanzia di essere thread-safe.

Un oggetto Stack può supportare più lettori simultaneamente, purché l'insieme non venga modificato. Tuttavia, l'enumerazione di un insieme non è di per sé una procedura thread-safe. Per garantire che l'enumerazione sia thread-safe, è possibile bloccare l'insieme durante l'intera enumerazione. Per consentire l'accesso all'insieme in lettura e scrittura da parte di più thread, è necessario implementare una sincronizzazione personalizzata.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:

.NET Compact Framework

Supportato in:

XNA Framework

Supportato in:

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft