BackgroundWorker.IsBusy Eigenschaft

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.EventBasedAsync.dll

Quelle:

BackgroundWorker.cs

Ruft einen Wert ab, der angibt, ob BackgroundWorker einen asynchronen Vorgang ausführt.

public:
 property bool IsBusy { bool get(); };

public bool IsBusy { get; }

member this.IsBusy : bool

Public ReadOnly Property IsBusy As Boolean

Eigenschaftswert

Boolean

true, wenn der BackgroundWorker einen asynchronen Vorgang ausführt, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IsBusy -Eigenschaft verwendet wird, um auf den Abschluss eines BackgroundWorker Vorgangs zu warten. Dieses Codebeispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Herunterladen einer Datei im Hintergrund beschrieben wird.

private void downloadButton_Click(object sender, EventArgs e)
{
    // Start the download operation in the background.
    this.backgroundWorker1.RunWorkerAsync();

    // Disable the button for the duration of the download.
    this.downloadButton.Enabled = false;

    // Once you have started the background thread you 
    // can exit the handler and the application will 
    // wait until the RunWorkerCompleted event is raised.

    // Or if you want to do something else in the main thread,
    // such as update a progress bar, you can do so in a loop 
    // while checking IsBusy to see if the background task is
    // still running.

    while (this.backgroundWorker1.IsBusy)
    {
        progressBar1.Increment(1);
        // Keep UI messages moving, so the form remains 
        // responsive during the asynchronous operation.
        Application.DoEvents();
    }
}

Private Sub downloadButton_Click( _
    ByVal sender As Object, _
    ByVal e As EventArgs) _
    Handles downloadButton.Click

    ' Start the download operation in the background.
    Me.backgroundWorker1.RunWorkerAsync()

    ' Disable the button for the duration of the download.
    Me.downloadButton.Enabled = False

    ' Once you have started the background thread you 
    ' can exit the handler and the application will 
    ' wait until the RunWorkerCompleted event is raised.

    ' If you want to do something else in the main thread,
    ' such as update a progress bar, you can do so in a loop 
    ' while checking IsBusy to see if the background task is
    ' still running.
    While Me.backgroundWorker1.IsBusy
        progressBar1.Increment(1)
        ' Keep UI messages moving, so the form remains 
        ' responsive during the asynchronous operation.
        Application.DoEvents()
    End While
End Sub

Hinweise

Startet BackgroundWorker einen asynchronen Vorgang, wenn Sie aufrufen RunWorkerAsync.

Weitere Informationen

• RunWorkerCompleted
• EventArgs
• RunWorkerAsync
• How to: Ausführen eines Vorgangs im Hintergrund
• Vorgehensweise: Downloaden einer Datei im Hintergrund