Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Parallel.For (Int64, Int64, Action<Int64, ParallelLoopState>)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Esegue un loop for (For in Visual Basic) con gli indici a 64 bit in cui le iterazioni possono eseguire in parallelo e lo stato del loop può essere monitorato e manipolato.

Spazio dei nomi:   System.Threading.Tasks
Assembly:  mscorlib (in mscorlib.dll)

public static ParallelLoopResult For(
	long fromInclusive,
	long toExclusive,
	Action<long, ParallelLoopState> body
)

Parametri

fromInclusive
Type: System.Int64

Indice iniziale, incluso.

toExclusive
Type: System.Int64

Indice finale, escluso.

body
Type: System.Action<Int64, ParallelLoopState>

Delegato richiamato una volta per iterazione.

Valore restituito

Type: System.Threading.Tasks.ParallelLoopResult

Struttura ParallelLoopResult che contiene informazioni sulla parte di ciclo completata.

Exception Condition
ArgumentNullException

Il valore dell'argomento body è null.

AggregateException

Eccezione che contiene tutte le singole eccezioni generate in tutti i thread.

Il body delegato viene richiamato una volta per ogni valore nell'intervallo di iterazione (fromInclusive, toExclusive). Viene fornito con i seguenti parametri: il conteggio delle iterazioni (Int64) e un ParallelLoopState istanza che può essere utilizzata per uscire dal ciclo in modo anomalo.

La chiamata di Break metodo informa il for operazione iterazioni dopo quella corrente non devono essere eseguiti, ma eseguire tutte le iterazioni prima di quello corrente.

Pertanto, la chiamata di interruzione è simile all'utilizzo di un'operazione di interruzione all'interno di un tradizionale for ciclo in un linguaggio come c#, ma non è un sostituto perfetto: ad esempio, non è garantito che le iterazioni dopo quello corrente senz'altro non verrà eseguito.

Se l'esecuzione di tutte le iterazioni prima di quella corrente non è necessario, utilizzare il Stop metodo anziché Break. La chiamata Stop informa il for ciclo che può abbandonare tutte le rimanenti iterazioni, indipendentemente dal fatto che essi si prima o dopo l'iterazione corrente, in quanto tutti necessari lavoro verrà sono già stato completato. Tuttavia, come con Break, non vi sono garanzie riguardo a quali altre iterazioni non verranno eseguito.

Se è stato interrotta, a un ciclo di ParallelLoopResult struttura restituito conterrà informazioni pertinenti sul completamento del ciclo.

Se fromInclusive è maggiore o uguale a toExclusive, il metodo restituisce immediatamente senza eseguire nessuna iterazione.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 4.0
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: