Public ReadOnly Property InvokeRequired As Boolean

Dim instance As Control
Dim value As Boolean

value = instance.InvokeRequired

public bool InvokeRequired { get; }

public:
virtual property bool InvokeRequired {
    bool get () sealed;
}

/** @property */
public final boolean get_InvokeRequired ()

public final function get InvokeRequired () : boolean

属性值

Windows 窗体中的控件被绑定到特定的线程，不具备线程安全性。因此，如果从另一个线程调用控件的方法，那么必须使用控件的一个 Invoke 方法来将调用封送到适当的线程。该属性可用于确定是否必须调用 Invoke 方法，当不知道什么线程拥有控件时这很有用。

注意
除了 InvokeRequired 属性以外，控件上还有以下四个线程安全的方法可供调用：Invoke、BeginInvoke、EndInvoke 和 CreateGraphics。对于所有其他方法调用，当从另一个线程进行调用时，应使用这些 Invoke 方法之一。

如果控件句柄尚不存在，则 InvokeRequired 沿控件的父级链搜索，直到它找到有窗口句柄的控件或窗体为止。如果找不到合适的句柄，InvokeRequired 方法将返回 false。

这意味着如果不需要 Invoke（调用发生在同一线程上），或者如果控件是在另一个线程上创建的但尚未创建控件的句柄，则 InvokeRequired 可以返回 false。

如果尚未创建控件的句柄，您就不能简单地在控件上调用属性、方法或事件。这可能导致在后台线程上创建控件的句柄，从而隔离不带消息泵的线程上的控件并使应用程序不稳定。

当 InvokeRequired 在后台线程上返回 false 时，您也可以通过检查 IsHandleCreated 的值来避免这种情况。如果尚未创建控件句柄，您必须等到控件句柄已创建，才能调用 Invoke 或 BeginInvoke。通常，仅当在应用程序主窗体的构造函数中创建了后台线程时（如同在 Application.Run(new MainForm()) 中），在已经显示窗体或取消 Application.Run 之前，才会发生这种情况。

一种解决方案是等到已经创建了窗体的句柄，然后启动后台线程。通过调用 Handle 属性强制创建句柄，或者等待 Load 事件启动后台进程。

一种更好的解决方案是使用 SynchronizationContext 返回的 SynchronizationContext，而不是使用控件进行线程间封送处理。

注意
如果应当处理消息的线程不再处于活动状态，则可能会引发异常。

有关多线程 Windows 窗体控件的更多信息，请参见“如何：使用后台线程搜索文件”。

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

.NET Framework

.NET Compact Framework