Control.CheckForIllegalCrossThreadCalls Property


Gets or sets a value indicating whether to catch calls on the wrong thread that access a control's Handle property when an application is being debugged.

 static property bool CheckForIllegalCrossThreadCalls { bool get(); void set(bool value); };
public static bool CheckForIllegalCrossThreadCalls { get; set; }
member this.CheckForIllegalCrossThreadCalls : bool with get, set
Public Shared Property CheckForIllegalCrossThreadCalls As Boolean

Property Value


true if calls on the wrong thread are caught; otherwise, false.



When a thread other than the creating thread of a control tries to access one of that control's methods or properties, it often leads to unpredictable results. A common invalid thread activity is a call on the wrong thread that accesses the control's Handle property. Set CheckForIllegalCrossThreadCalls to true to find and diagnose this thread activity more easily while debugging.

Applies to