Task.RunSynchronously Metodo

Definizione

Spazio dei nomi:

System.Threading.Tasks

Assembly:

netstandard.dll, System.Runtime.dll

Esegue Task in modo sincrono nell'oggetto TaskScheduler corrente.

Overload

RunSynchronously()	Esegue Task in modo sincrono nell'oggetto TaskScheduler corrente.
RunSynchronously(TaskScheduler)	Esegue Task in modo sincrono nell'oggetto TaskScheduler fornito.

RunSynchronously()

Origine:

Task.cs

Esegue Task in modo sincrono nell'oggetto TaskScheduler corrente.

public void RunSynchronously();

Eccezioni

ObjectDisposedException

L’istanza di Task è stata eliminata.

InvalidOperationException

Task non è in uno stato valido per essere avviato. Potrebbe essere già stato avviato, eseguito o annullato oppure potrebbe essere stato creato in un modo che non supporta la pianificazione diretta.

Esempio

Nell'esempio seguente viene confrontata un'attività eseguita chiamando il RunSynchronously metodo con un'attività eseguita in modo asincrono. In entrambi i casi, le attività eseguono espressioni lambda identiche che visualizzano l'ID attività e l'ID del thread in cui è in esecuzione l'attività. L'attività calcola la somma dei numeri interi compresi tra 1 e 1.000.000. Come illustrato nell'output dell'esempio, l'attività eseguita chiamando il RunSynchronously metodo viene eseguita nel thread dell'applicazione, mentre l'attività asincrona non viene eseguita.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("Application executing on thread {0}",
                        Thread.CurrentThread.ManagedThreadId);
      var asyncTask = Task.Run( () => {  Console.WriteLine("Task {0} (asyncTask) executing on Thread {1}",
                                                           Task.CurrentId,
                                                           Thread.CurrentThread.ManagedThreadId);
                                         long sum = 0;
                                         for (int ctr = 1; ctr <= 1000000; ctr++ )
                                            sum += ctr;
                                         return sum;
                                      });
      var syncTask = new Task<long>( () =>  { Console.WriteLine("Task {0} (syncTask) executing on Thread {1}",
                                                                 Task.CurrentId,
                                                                 Thread.CurrentThread.ManagedThreadId);
                                              long sum = 0;
                                              for (int ctr = 1; ctr <= 1000000; ctr++ )
                                                 sum += ctr;
                                              return sum;
                                            });
      syncTask.RunSynchronously();
      Console.WriteLine();
      Console.WriteLine("Task {0} returned {1:N0}", syncTask.Id, syncTask.Result);
      Console.WriteLine("Task {0} returned {1:N0}", asyncTask.Id, asyncTask.Result);
   }
}
// The example displays the following output:
//       Application executing on thread 1
//       Task 1 (syncTask) executing on Thread 1
//       Task 2 (asyncTask) executing on Thread 3
//       1 status: RanToCompletion
//       2 status: RanToCompletion
//
//       Task 2 returned 500,000,500,000
//       Task 1 returned 500,000,500,000

Commenti

In genere, le attività vengono eseguite in modo asincrono in un thread del pool di thread e non bloccano il thread chiamante. Le attività eseguite chiamando il RunSynchronously() metodo sono associate all'oggetto corrente TaskScheduler e vengono eseguite nel thread chiamante. Se l'utilità di pianificazione di destinazione non supporta l'esecuzione di questa attività nel thread chiamante, l'attività verrà pianificata per l'esecuzione nell'utilità di pianificazione e il thread chiamante verrà bloccato fino al completamento dell'esecuzione dell'attività. Anche se l'attività viene eseguita in modo sincrono, il thread chiamante deve comunque chiamare Wait per gestire eventuali eccezioni che l'attività potrebbe generare. Per altre informazioni sulla gestione delle eccezioni, vedere Gestione delle eccezioni.

Le attività eseguite chiamando il metodo vengono create un'istanza RunSynchronously chiamando un costruttore di classe Task o Task<TResult> . L'attività da eseguire in modo sincrono deve trovarsi nello Created stato . Un'attività può essere avviata ed eseguita una sola volta. Qualsiasi tentativo di pianificare un'attività una seconda volta genera un'eccezione.

Vedi anche

• Gestione delle eccezioni (Task Parallel Library)

RunSynchronously(TaskScheduler)

Origine:

Task.cs

Esegue Task in modo sincrono nell'oggetto TaskScheduler fornito.

public void RunSynchronously(System.Threading.Tasks.TaskScheduler scheduler);

Parametri

scheduler

TaskScheduler

Utilità di pianificazione in cui provare a eseguire questa attività inline.

Eccezioni

ObjectDisposedException

L’istanza di Task è stata eliminata.

ArgumentNullException

Il valore dell'argomento scheduler è null.

InvalidOperationException

Task non è in uno stato valido per essere avviato. Potrebbe essere già stato avviato, eseguito o annullato oppure potrebbe essere stato creato in un modo che non supporta la pianificazione diretta.

Commenti

Le attività eseguite chiamando il metodo vengono create un'istanza RunSynchronously chiamando un costruttore di classe Task o Task<TResult> . L'attività da eseguire in modo sincrono deve trovarsi nello Created stato . Un'attività può essere avviata ed eseguita una sola volta. Qualsiasi tentativo di pianificare un'attività una seconda volta genera un'eccezione.

Se l'utilità di pianificazione di destinazione non supporta l'esecuzione di questa attività nel thread corrente, l'attività verrà pianificata per l'esecuzione nell'utilità di pianificazione e il thread corrente verrà bloccato fino al completamento dell'esecuzione dell'attività. Per questo motivo, il thread chiamante non deve chiamare un metodo, Wait ad esempio per assicurarsi che l'attività abbia completato l'esecuzione. Per altre informazioni sulla gestione delle eccezioni per le operazioni delle attività, vedere Gestione delle eccezioni.

Vedi anche

• TaskScheduler
• Gestione delle eccezioni (Task Parallel Library)