BackgroundWorker.DoWork Evento

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Source:

BackgroundWorker.cs

Si verifica quando viene chiamato il metodo RunWorkerAsync().

public:
 event System::ComponentModel::DoWorkEventHandler ^ DoWork;

public event System.ComponentModel.DoWorkEventHandler? DoWork;

member this.DoWork : System.ComponentModel.DoWorkEventHandler 

Public Custom Event DoWork As DoWorkEventHandler 

Tipo evento

DoWorkEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dell'evento DoWork per avviare un'operazione asincrona. Questo esempio di codice fa parte di un esempio più grande fornito per la BackgroundWorker classe.

// This event handler is where the actual,
// potentially time-consuming work is done.
void backgroundWorker1_DoWork( Object^ sender, DoWorkEventArgs^ e )
{
   // Get the BackgroundWorker that raised this event.
   BackgroundWorker^ worker = dynamic_cast<BackgroundWorker^>(sender);

   // Assign the result of the computation
   // to the Result property of the DoWorkEventArgs
   // object. This is will be available to the 
   // RunWorkerCompleted eventhandler.
   e->Result = ComputeFibonacci( safe_cast<Int32>(e->Argument), worker, e );
}

// This event handler is where the actual,
// potentially time-consuming work is done.
private void backgroundWorker1_DoWork(object sender, 
    DoWorkEventArgs e)
{   
    // Get the BackgroundWorker that raised this event.
    BackgroundWorker worker = sender as BackgroundWorker;

    // Assign the result of the computation
    // to the Result property of the DoWorkEventArgs
    // object. This is will be available to the 
    // RunWorkerCompleted eventhandler.
    e.Result = ComputeFibonacci((int)e.Argument, worker, e);
}

' This event handler is where the actual work is done.
Private Sub backgroundWorker1_DoWork( _
ByVal sender As Object, _
ByVal e As DoWorkEventArgs) _
Handles backgroundWorker1.DoWork

    ' Get the BackgroundWorker object that raised this event.
    Dim worker As BackgroundWorker = _
        CType(sender, BackgroundWorker)

    ' Assign the result of the computation
    ' to the Result property of the DoWorkEventArgs
    ' object. This is will be available to the 
    ' RunWorkerCompleted eventhandler.
    e.Result = ComputeFibonacci(e.Argument, worker, e)
End Sub

Commenti

Questo evento viene generato quando si chiama il RunWorkerAsync metodo. Questo è il punto in cui si avvia l'operazione che esegue il lavoro potenzialmente necessario.

Il codice nel DoWork gestore eventi deve controllare periodicamente il valore della CancellationPending proprietà e interrompere l'operazione se è true. Quando si verifica questo problema, è possibile impostare il Cancel flag di su truee il Cancelled flag di System.ComponentModel.DoWorkEventArgsSystem.ComponentModel.RunWorkerCompletedEventArgs nel RunWorkerCompleted gestore eventi verrà impostato su true.

Attenzione

Tenere presente che il DoWork codice nel gestore eventi può completare il proprio lavoro come richiesta di annullamento e il ciclo di polling potrebbe non CancellationPending essere impostato su true. In questo caso, il Cancelled flag di nel RunWorkerCompleted gestore eventi non verrà impostato su true, anche se è stata effettuata una richiesta di System.ComponentModel.RunWorkerCompletedEventArgs annullamento. Questa situazione è chiamata condizione di gara ed è una preoccupazione comune nella programmazione multithreaded. Per altre informazioni sui problemi di progettazione multithreading, vedere Procedure consigliate per il threading gestito.

Se l'operazione genera un risultato, è possibile assegnare il risultato alla DoWorkEventArgs.Result proprietà. Questo sarà disponibile per il RunWorkerCompleted gestore eventi nella RunWorkerCompletedEventArgs.Result proprietà.

Se l'operazione genera un'eccezione che il codice non gestisce, rileva BackgroundWorker l'eccezione e la passa nel RunWorkerCompleted gestore eventi, dove viene esposta come Error proprietà di System.ComponentModel.RunWorkerCompletedEventArgs. Se si esegue nel debugger di Visual Studio, il debugger verrà interrotto nel punto del gestore eventi in DoWork cui è stata generata l'eccezione non gestita. Se sono presenti più di un BackgroundWorkeroggetto , non è consigliabile fare riferimento direttamente a nessuno di essi, in quanto il gestore eventi verrà coppia DoWork con un'istanza specifica di BackgroundWorker. È invece necessario accedere BackgroundWorker al parametro eseguendo il cast del sender parametro nel DoWork gestore eventi.

È necessario prestare attenzione a non modificare gli oggetti dell'interfaccia utente nel DoWork gestore eventi. Comunicare invece all'interfaccia utente tramite gli BackgroundWorker eventi.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Vedi anche

• Procedura: Eseguire un'operazione in background
• Suggerimenti per l'utilizzo del threading gestito
• Procedura: Scaricare un file in background