Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

DoWorkEventArgs Class

Definition

Namespace:
System.ComponentModel
Assemblies:
System.dll, System.ComponentModel.EventBasedAsync.dll
Assemblies:
netstandard.dll, System.ComponentModel.EventBasedAsync.dll
Assembly:
System.ComponentModel.EventBasedAsync.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
DoWorkEvent.cs
Source:
DoWorkEvent.cs
Source:
DoWorkEvent.cs
Source:
DoWorkEvent.cs
Source:
DoWorkEvent.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides data for the DoWork event handler.

public ref class DoWorkEventArgs : EventArgs
public ref class DoWorkEventArgs : System::ComponentModel::CancelEventArgs
public class DoWorkEventArgs : EventArgs
public class DoWorkEventArgs : System.ComponentModel.CancelEventArgs
type DoWorkEventArgs = class
 inherit EventArgs
type DoWorkEventArgs = class
 inherit CancelEventArgs
Public Class DoWorkEventArgs
Inherits EventArgs
Public Class DoWorkEventArgs
Inherits CancelEventArgs
Inheritance
DoWorkEventArgs
Inheritance
DoWorkEventArgs

Examples

The following code example demonstrates how to use the DoWorkEventArgs class to handle the DoWork event. For a full code listing, see How to: Run an Operation in the Background.

void backgroundWorker1_DoWork(object sender, DoWorkEventArgs e)
{
 // Do not access the form's BackgroundWorker reference directly.
 // Instead, use the reference provided by the sender parameter.
 BackgroundWorker bw = sender as BackgroundWorker;

 // Extract the argument.
 int arg = (int)e.Argument;

 // Start the time-consuming operation.
 e.Result = TimeConsumingOperation(bw, arg);

 // If the operation was canceled by the user, 
 // set the DoWorkEventArgs.Cancel property to true.
 if (bw.CancellationPending)
 {
 e.Cancel = true;
 }
}
Private Sub backgroundWorker1_DoWork( _
sender As Object, e As DoWorkEventArgs) _
Handles backgroundWorker1.DoWork

 ' Do not access the form's BackgroundWorker reference directly.
 ' Instead, use the reference provided by the sender parameter.
 Dim bw As BackgroundWorker = CType( sender, BackgroundWorker )
 
 ' Extract the argument.
 Dim arg As Integer = Fix(e.Argument)
 
 ' Start the time-consuming operation.
 e.Result = TimeConsumingOperation(bw, arg)
 
 ' If the operation was canceled by the user, 
 ' set the DoWorkEventArgs.Cancel property to true.
 If bw.CancellationPending Then
 e.Cancel = True
 End If

End Sub

Constructors

Name Description
DoWorkEventArgs(Object)

Initializes a new instance of the DoWorkEventArgs class.

Properties

Name Description
Argument

Gets a value that represents the argument of an asynchronous operation.

Cancel
Cancel

Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Result

Gets or sets a value that represents the result of an asynchronous operation.

Methods

Name Description
Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also


Feedback

Was this page helpful?