Control.CheckForIllegalCrossThreadCalls Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.
public:
static property bool CheckForIllegalCrossThreadCalls { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public static bool CheckForIllegalCrossThreadCalls { get; set; }
[<System.ComponentModel.Browsable(false)>]
static member CheckForIllegalCrossThreadCalls : bool with get, set
Public Shared Property CheckForIllegalCrossThreadCalls As Boolean
Property Value
true
if calls on the wrong thread are caught; otherwise, false
.
- Attributes
Remarks
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.