BackgroundWorker.RunWorkerAsync Method (Object)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Starts running a background operation and includes a parameter for use by the background operation.

Namespace:  System.ComponentModel
Assembly:  System (in System.dll)

Syntax

Public Sub RunWorkerAsync ( _
    argument As Object _
)
public void RunWorkerAsync(
    Object argument
)

Parameters

Exceptions

Exception Condition
InvalidOperationException

IsBusy is true.

Remarks

The RunWorkerAsync method submits a request to start the operation running asynchronously. When the request is processed, the DoWork event is raised, which in turn starts running your background operation.

If your background operation requires a parameter, you can provide it as the argument parameter to RunWorkerAsync.

If the background operation is already running, calling RunWorkerAsync again will raise an InvalidOperationException.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

BackgroundWorker Class

RunWorkerAsync Overload

System.ComponentModel Namespace

Other Resources

How to use a background worker for Windows Phone 8

Managed Threading

Managed Threading Best Practices