Export (0) Print
Expand All
Expand Minimize

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, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

ADD
Show:
© 2014 Microsoft