Export (0) Print
Expand All

Control.EndInvoke Method

Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public Object EndInvoke(
	IAsyncResult asyncResult
)

Parameters

asyncResult
Type: System.IAsyncResult

The IAsyncResult that represents a specific invoke asynchronous operation, returned when calling BeginInvoke.

Return Value

Type: System.Object
The Object generated by the asynchronous operation.

Implements

ISynchronizeInvoke.EndInvoke(IAsyncResult)

ExceptionCondition
ArgumentNullException

The asyncResult parameter value is null.

ArgumentException

The asyncResult object was not created by a preceding call of the BeginInvoke method from the same control.

If the asynchronous operation has not been completed, this function will block until the result is available.

NoteNote

In addition to the InvokeRequired property, there are four methods on a control that are thread safe: Invoke, BeginInvoke, EndInvoke, and CreateGraphics if the handle for the control has already been created. Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft