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, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft