Condividi tramite

Istruzioni di iterazione - for, foreach, doe while

Le istruzioni di iterazione eseguono ripetutamente un'istruzione o un blocco di istruzioni. L'istruzionefor esegue il corpo mentre un'espressione booleana specificata restituisce true. L'istruzioneforeach enumera gli elementi di una raccolta ed esegue il relativo corpo per ogni elemento della raccolta. L'istruzionedo esegue in modo condizionale il suo corpo uno o più volte. L'istruzionewhile esegue in modo condizionale il corpo zero o più volte.

In qualsiasi punto all'interno del corpo di un'istruzione di iterazione, è possibile interrompere il ciclo usando l'istruzionebreak . È possibile passare all'iterazione successiva nel ciclo usando l'istruzionecontinue .

Istruzione for

L'istruzione for esegue un'istruzione o un blocco di istruzioni mentre un'espressione booleana specificata restituisce true. L'esempio seguente mostra l'istruzione for che esegue il suo corpo mentre un contatore intero è minore di tre.

for (int i = 0; i < 3; i++)
{
    Console.Write(i);
}
// Output:
// 012

L'esempio precedente mostra gli elementi dell'istruzione for :

  • Sezione dell'inizializzatore eseguita una sola volta, prima di immettere il ciclo. In genere, si dichiara e inizializza una variabile di ciclo locale in tale sezione. Non è possibile accedere alla variabile dichiarata dall'esterno dell'istruzione for .

    La sezione inizializzatore nell'esempio precedente dichiara e inizializza una variabile di contatore integer:

    int i = 0

  • Sezione condizione che determina se deve essere eseguita l'iterazione successiva nel ciclo. Se restituisce true o non è presente, viene eseguita l'iterazione successiva. In caso contrario, il ciclo viene chiuso. La sezione condizione deve essere un'espressione booleana.

    La sezione condizione nell'esempio precedente controlla se un valore del contatore è minore di tre:

    i < 3

  • Sezione iteratore che definisce cosa accade dopo ogni esecuzione del corpo del ciclo.

    La sezione iteratore nell'esempio precedente incrementa il contatore:

    i++

  • Corpo del ciclo, che deve essere un'istruzione o un blocco di istruzioni.

La sezione iteratore può contenere zero o più espressioni di istruzione seguenti, separate da virgole:

Se non si dichiara una variabile di ciclo nella sezione inizializzatore, è possibile usare zero o più espressioni dell'elenco precedente nella sezione inizializzatore. L'esempio seguente mostra diversi utilizzi meno comuni delle sezioni inizializzatore e iteratore: assegnazione di un valore a una variabile esterna nella sezione inizializzatore, richiamo di un metodo nelle sezioni inizializzatore e iteratore e modifica dei valori di due variabili nella sezione iteratore:

int i;
int j = 3;
for (i = 0, Console.WriteLine($"Start: i={i}, j={j}"); i < j; i++, j--, Console.WriteLine($"Step: i={i}, j={j}"))
{
    //...
}
// Output:
// Start: i=0, j=3
// Step: i=1, j=2
// Step: i=2, j=1

Tutte le sezioni dell'istruzione for sono facoltative. Ad esempio, il codice seguente definisce il ciclo infinito for :

for ( ; ; )
{
    //...
}

Istruzione foreach

L'istruzione foreach esegue un'istruzione o un blocco di istruzioni per ogni elemento in un'istanza del tipo che implementa l'interfaccia System.Collections.IEnumerable o System.Collections.Generic.IEnumerable<T> , come illustrato nell'esempio seguente:

List<int> fibNumbers = new() { 0, 1, 1, 2, 3, 5, 8, 13 };
foreach (int element in fibNumbers)
{
    Console.Write($"{element} ");
}
// Output:
// 0 1 1 2 3 5 8 13

L'istruzione foreach non è limitata a questi tipi. È possibile usarlo con un'istanza di qualsiasi tipo che soddisfi le condizioni seguenti:

  • Un tipo ha il metodo pubblico senza parametri GetEnumerator. Il GetEnumerator metodo può essere un metodo di estensione di un tipo.
  • Il tipo restituito del metodo GetEnumerator ha la proprietà pubblica Current e il metodo pubblico senza parametri MoveNext il cui tipo restituito è bool.

L'esempio seguente usa l'istruzione foreach con un'istanza del tipo System.Span<T>, che non implementa interfacce.

Span<int> numbers = [3, 14, 15, 92, 6];
foreach (int number in numbers)
{
    Console.Write($"{number} ");
}
// Output:
// 3 14 15 92 6

Se la proprietà dell'enumeratore Current restituisce un valore restituito di riferimento (ref T dove T è il tipo di un elemento della raccolta), è possibile dichiarare una variabile di iterazione con il ref modificatore o ref readonly , come illustrato nell'esempio seguente:

Span<int> storage = stackalloc int[10];
int num = 0;
foreach (ref int item in storage)
{
    item = num++;
}
foreach (ref readonly var item in storage)
{
    Console.Write($"{item} ");
}
// Output:
// 0 1 2 3 4 5 6 7 8 9

Se la raccolta di origine dell'istruzione foreach è vuota, il corpo dell'istruzione foreach non viene eseguito e ignorato. Se l'istruzione foreach viene applicata a null, viene generata un'eccezione NullReferenceException .

await foreach

È possibile usare l'istruzione await foreach per utilizzare un flusso asincrono di dati, ovvero il tipo di raccolta che implementa l'interfaccia IAsyncEnumerable<T> . Ogni iterazione del ciclo può essere sospesa mentre l'elemento successivo viene recuperato in modo asincrono. L'esempio seguente illustra come usare l'istruzione await foreach :

await foreach (var item in GenerateSequenceAsync())
{
    Console.WriteLine(item);
}

È anche possibile usare l'istruzione await foreach con un'istanza di qualsiasi tipo che soddisfi le condizioni seguenti:

  • Un tipo ha il metodo pubblico senza parametri GetAsyncEnumerator. Questo metodo può essere un metodo di estensione di un tipo.
  • Il tipo restituito del metodo GetAsyncEnumerator ha la proprietà pubblica Current e il metodo pubblico senza parametri MoveNextAsync il cui tipo restituito è Task<bool>, ValueTask<bool>, o qualsiasi altro tipo attendibile il cui metodo attenditore GetResult restituisce un valore bool.

Per impostazione predefinita, gli elementi del flusso vengono elaborati nel contesto acquisito. Se si vuole disabilitare l'acquisizione del contesto, usare il TaskAsyncEnumerableExtensions.ConfigureAwait metodo di estensione. Per altre informazioni sui contesti di sincronizzazione e sull'acquisizione del contesto corrente, vedere Utilizzo del modello asincrono basato su attività. Per altre informazioni sui flussi asincroni, vedere l'esercitazione Sui flussi asincroni.

Tipo di variabile di iterazione

È possibile usare la var parola chiave per consentire al compilatore di dedurre il tipo di una variabile di iterazione nell'istruzione foreach , come illustrato nel codice seguente:

foreach (var item in collection) { }

Annotazioni

Il tipo di var può essere dedotto dal compilatore come tipo riferimento nullable, a seconda che il contesto con riconoscimento nullable sia abilitato e se il tipo di un'espressione di inizializzazione sia un tipo riferimento. Per altre informazioni, vedere Variabili locali tipizzate in modo implicito.

È anche possibile specificare in modo esplicito il tipo di una variabile di iterazione, come illustrato nel codice seguente:

IEnumerable<T> collection = new T[5];
foreach (V item in collection) { }

Nel formato precedente, il tipo T di un elemento della raccolta deve essere implicitamente o convertibile in modo esplicito nel tipo V di una variabile di iterazione. Se una conversione esplicita da T a V ha esito negativo in fase di esecuzione, l'istruzione foreach genera un'eccezione InvalidCastException. Ad esempio, se T è un tipo di classe non sealed, V può essere qualsiasi tipo di interfaccia, anche quello che T non implementa. In fase di esecuzione, il tipo di un elemento della raccolta può essere quello che deriva da T e che effettivamente implementa V. In caso contrario, viene generata un'eccezione InvalidCastException .

Istruzione do

L'istruzione do esegue un'istruzione o un blocco di istruzioni mentre un'espressione booleana specificata restituisce true. Poiché tale espressione viene valutata dopo ogni esecuzione del ciclo, un do ciclo viene eseguito una o più volte. Il do ciclo è diverso dal while ciclo , che esegue zero o più volte.

L'esempio seguente illustra l'utilizzo dell'istruzione do :

int n = 0;
do
{
    Console.Write(n);
    n++;
} while (n < 5);
// Output:
// 01234

Istruzione while

L'istruzione while esegue un'istruzione o un blocco di istruzioni mentre un'espressione booleana specificata restituisce true. Poiché tale espressione viene valutata prima di ogni esecuzione del ciclo, un while ciclo viene eseguito zero o più volte. Il while ciclo è diverso dal do ciclo , che esegue una o più volte.

L'esempio seguente illustra l'utilizzo dell'istruzione while :

int n = 0;
while (n < 5)
{
    Console.Write(n);
    n++;
}
// Output:
// 01234

Specificazione del linguaggio C#

Per altre informazioni, vedere le sezioni seguenti delle specifiche del linguaggio C#:

Per altre informazioni su queste funzionalità, vedere le note sulla proposta di funzionalità seguenti:

Vedere anche