preoparazione inziaile:

• creazione oggetto
come prima cosa occorre creare un oggetto di tipo BackgroundWorker()
BackgroundWorker oggetto = new BackgroundWorker()

oppure inserire un componente dalla toolbar nella sezione Componenti → BackgroundWorker




• settaggio propietà
occorre specifiare nelle proprietà del componente, o se aggiunto manualmete dopo l'inizializzazione della Form o se si vuole che sia consentito:


• cancellazione: oggetto.WorkerSupportsCancellation = true
• interrogazione del progresso: oggetto.WorkerReportsProgress = true




• attivazione o cancellazione
il processo in background viene attivato, o cancellato tramite dei metodi/comandi che si possono associare a dei bottoni e a degli eventi:


• oggetto.RunWorkerAsync() fa partire il DoWork relativo all'oggetto/processo in background indicato
occorre prima verificare se il processo non é già attivo oggetto.IsBusy == true

esempio: attivo processo se non già attivo
if (bwBackup.IsBusy != true)se non é già in azione
{

bwBackup.RunWorkerAsync(); inizia il processo _DoWork in background

}



• oggetto.CancelAsync() cancella il processo in background relativo all'oggetto

in realtà invia al _DoWork una richiesta di cancellazione
nel codice ci deve essere l'interrogazione della proprietà .CancellationPending se se é true allora di decide che fare (ex. blocco del ciclo)


esempio: cancello il porcesso dopo il controllo se cancellabile
if (bwBackup.WorkerSupportsCancellation == true)se il processo é cancellabile
{

bwBackup.CancelAsync(); gli modifico il parametro .CancellationPending in true

}

esecuzione codice e gestione eventi
vanno creati degli eventi che gestiscono il processo in background

• _DoWork
consiste nella vera e propria routine da eseguire in background

per prima cosa si crea un oggetto/sessione in modo che sia possiabile verificare lo stato del metodo ed ventuali richieste di cancellazione
BackgroundWorker worker = sender as BackgroundWorker;


poi si inseriscono i vari cicli e comandi da eseguire con le varie verifiche dello stato:


• per le istruzioni più importanti si verifica sempre che non ci sia stata una richiesta di blocco/cancellazione
if (worker.CancellationPending == true)

e quindi le istruzioni da eseguire in questo caso magari passando un stato Cancel a RunWorkerCompleted
e.Cancel = true




• all'interno del codice é possibile richiamare l'evento _ProgressChanged tramite il metodo
.ReportProgress(valori da passare)




finito tutto il processo si attiva l'evento _RunWorkerCompleted



esempio: creo una routine in background di un conteggio da 10 a 100
private void bwBackup_DoWork(object sender, DoWorkEventArgs e)
{

BackgroundWorker worker = sender as BackgroundWorker; creo una sessione del tipo sender passato come argomento

for (int i = 1; i <= 10; i++)
{

if (worker.CancellationPending == true) si controlla lo stato del .CancellationPending per determinare se l'oggetto passato sender era cancellato, quindi una richiesta di cancellazione
{

e.Cancel = true; importo quindi al DoWorkEventArgs come cancellato e chiudo il ciclo, questo sarà passato come parametro nel RunWorkerCompleted indicato lo stato di cancellazione
break;

}
else
{

System.Threading.Thread.Sleep(500); temporizzazione del processo per rallentarlo
worker.ReportProgress(i * 10); richiamo l'evento ProgressChanged passando il risultato della moltiplicazione

}

}

}



• ProgressChanged
metodo che viene richiamato quando il processo in background invia gli aggiornamenti

il metodo riceve un parametro e
per leggere il valore del parametro si usa il metodo:

.ProgressPercentage

esempio: scrivo una lable con i dati passati
private void bwBackup_ProgressChanged(object sender, ProgressChangedEventArgs e)
{

this.lable.Text = (e.ProgressPercentage.ToString());

}




• RunWorkerCompleted
metodo che si attiva alla fine del processo in background

il metodo riceve un parametro e
che contiene i dati da interrogare per verificare il motivo del fine processo

dati:
• e.Cancelled == true verifica se il processo é stato cancellato
• e.Error == null verifica il processo principale si sia chiuso causa errore

esempio:
private void bwBackup_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{

if ((e.Cancelled == true)) verifica se il processo é stato cancellato
{

this.tbProgress.Text = "Canceled!";

}

else if (!(e.Error == null)) verifica se non ci sono stati errori
{

this.tbProgress.Text = ("Error: " + e.Error.Message);

}

else
{

this.tbProgress.Text = "Done!";

}

}