Modello di programmazione asincrona (APM)

Un'operazione asincrona in cui viene usato il modello di progettazione dell'oggetto IAsyncResult viene implementata come due metodi denominati BeginOperationName e EndOperationName tramite cui viene rispettivamente avviata e terminata l'operazione asincrona NomeOperazione. La classe FileStream fornisce ad esempio i metodi BeginRead e EndRead per la lettura asincrona dei byte da un file. Tali metodi implementano la versione asincrona del metodo Read .

Nota

A partire da .NET Framework 4, Task Parallel Library fornisce un nuovo modello di programmazione asincrona e parallela. Per altre informazioni, vedere Task Parallel Library (TPL) e Task-based Asynchronous Pattern (TAP).

Dopo aver chiamato il metodo BeginOperationName, l'app può continuare a eseguire le istruzioni nel thread chiamante mentre l'operazione asincrona viene eseguita in un altro thread. Per ogni chiamata a BeginOperationName, l'app deve chiamare anche il metodo EndOperationName per ottenere i risultati dell'operazione.

Avvio di un'operazione asincrona

Il metodo BeginOperationName avvia l'operazione asincrona NomeOperazione e restituisce un oggetto che implementa l'interfaccia IAsyncResult. Gli oggettiIAsyncResult archiviano le informazioni sulle operazioni asincrone. La tabella seguente illustra le informazioni relative a un'operazione asincrona.

Membro	Descrizione
AsyncState	Oggetto facoltativo specifico dell'applicazione che contiene informazioni sull'operazione asincrona.
AsyncWaitHandle	Oggetto WaitHandle che può essere usato per bloccare l'esecuzione dell'applicazione fino al completamento dell'operazione asincrona.
CompletedSynchronously	Valore che indica l'eventuale completamento dell'operazione asincrona nel thread usato per chiamare il metodo BeginOperationName anziché in un thread ThreadPool separato.
IsCompleted	Valore che indica l'eventuale completamento dell'operazione asincrona.

In un metodo BeginOperationName vengono accettati tutti i parametri dichiarati nella firma della versione sincrona del metodo passati per valore o riferimento. Nella firma del metodo BeginOperationName non sono inclusi parametri out. Il metodo BeginOperationName include invece due parametri aggiuntivi. Il primo dei quali definisce un delegato AsyncCallback che fa riferimento a un metodo chiamato al completamento dell'operazione asincrona. Il chiamante può specificare null (Nothing in Visual Basic) se non vuole richiamare un metodo al termine dell'operazione. Il secondo parametro aggiuntivo è un oggetto definito dall'utente che può essere usato per passare informazioni sullo stato specifiche dell'applicazione al metodo richiamato al completamento dell'operazione asincrona. Se in un metodo BeginOperationName sono accettati altri parametri specifici dell'operazione, ad esempio una matrice di byte per l'archiviazione dei byte letti da un file, l'oggetto AsyncCallback e l'oggetto stato dell'applicazione saranno gli ultimi parametri nella firma del metodo BeginOperationName.

Il metodo BeginOperationName restituisce immediatamente il controllo al thread chiamante. Se il metodo BeginOperationName genera eccezioni, ciò avviene prima dell'avvio dell'operazione asincrona e il metodo BeginOperationNamedi callback non viene richiamato.

Fine di un'operazione asincrona

Il metodo EndOperationName termina l'operazione asincrona NomeOperazione. Il valore restituito dal metodo EndOperationName è dello stesso tipo restituito dalla controparte sincrona ed è specifico dell'operazione asincrona. Il metodo EndRead restituisce ad esempio il numero di byte letti da un oggetto FileStream mentre il metodo EndGetHostByName restituisce un oggetto IPHostEntry contenente le informazioni relative a un computer host. Il metodo EndOperationName accetta tutti i parametri out o ref dichiarati nella firma della versione sincrona del metodo. Oltre ai parametri provenienti dal metodo sincrono, nel metodo EndOperationName è incluso anche un parametro IAsyncResult. I chiamanti devono passare l'istanza restituita dalla chiamata corrispondente al metodo BeginOperationName.

Se l'operazione asincrona rappresentata dall'oggetto IAsyncResult non è stata completata quando viene chiamato il metodo EndOperationName, EndOperationNamequest'ultimo blocca il thread chiamante fino al completamento dell'operazione. Le eccezioni generate dall'operazione asincrona vengono generate dal metodo EndOperationName. Non è definito l'effetto della chiamata ripetuta del metodo EndOperationName con lo stesso oggetto IAsyncResult, come anche della chiamata del metodo EndOperationName con un oggetto IAsyncResult non restituito dal metodo Begin correlato.

Nota

In questi due scenari non definiti ai responsabili dell'implementazione è consigliata la generazione di InvalidOperationException.

Nota

I responsabili dell'implementazione di questo schema progettuale devono notificare al chiamante il completamento dell'operazione asincrona impostando IsCompleted su true, chiamando il metodo di callback asincrono, se specificato, e segnalando l'oggetto AsyncWaitHandle.

Gli sviluppatori di applicazioni dispongono di diverse scelte di progettazione per accedere ai risultati dell'operazione asincrona. La scelta adeguata dipende dall'eventuale presenza nell'applicazione di istruzioni che possono essere eseguite durante il completamento dell'operazione. Se l'applicazione non consente di eseguire altre attività fino alla ricezione dei risultati dell'operazione asincrona, deve essere bloccata fino a quel momento. A tale scopo, sono disponibili i due approcci illustrati di seguito:

• Chiamare il metodo EndOperationName dal thread principale dell'applicazione, bloccando l'esecuzione dell'applicazione fino al completamento dell'operazione. Per un esempio relativo all'uso di questa tecnica, vedere Blocco dell'esecuzione dell'applicazione terminando un'operazione asincrona.

• Usare AsyncWaitHandle per bloccare l'esecuzione dell'applicazione fino al completamento di una o più operazioni. Per un esempio relativo all'uso di questa tecnica, vedere Blocking Application Execution Using an AsyncWaitHandle.

Per le applicazioni che non è necessario bloccare durante il completamento dell'operazione asincrona, è possibile usare uno degli approcci seguenti:

• Eseguire il polling dello stato di completamento dell'operazione verificando periodicamente la proprietà IsCompleted e chiamando il metodo EndOperationName al completamento dell'operazione. Per un esempio relativo all'uso di questa tecnica, vedere Polling for the Status of an Asynchronous Operation.

• Usare un delegato AsyncCallback per specificare il metodo da richiamare quando l'operazione viene completata. Per un esempio relativo all'uso di questa tecnica, vedere Using an AsyncCallback Delegate to End an Asynchronous Operation.

Vedi anche

• Event-based Asynchronous Pattern (EAP) (Modello asincrono basato su eventi, EAP)
• Chiamata di metodi sincroni in modalità asincrona
• Uso di un oggetto di stato e di un delegato AsyncCallback