Thread.Suspend Method (System.Threading)

Suspend Method

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Thread..::.Suspend Method

NOTE: This API is now obsolete.

Either suspends the thread, or if the thread is already suspended, has no effect.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

<ObsoleteAttribute("Thread.Suspend has been deprecated.  Please use other classes in System.Threading, such as Monitor, Mutex, Event, and Semaphore, to synchronize Threads or protect resources.  http://go.microsoft.com/fwlink/?linkid=14202",  _
    False)> _
<SecurityPermissionAttribute(SecurityAction.Demand, ControlThread := True)> _
<SecurityPermissionAttribute(SecurityAction.Demand, ControlThread := True)> _
Public Sub Suspend

Visual Basic (Usage)

Dim instance As Thread

instance.Suspend()

[ObsoleteAttribute("Thread.Suspend has been deprecated.  Please use other classes in System.Threading, such as Monitor, Mutex, Event, and Semaphore, to synchronize Threads or protect resources.  http://go.microsoft.com/fwlink/?linkid=14202", 
    false)]
[SecurityPermissionAttribute(SecurityAction.Demand, ControlThread = true)]
[SecurityPermissionAttribute(SecurityAction.Demand, ControlThread = true)]
public void Suspend()

Visual C++

[ObsoleteAttribute(L"Thread.Suspend has been deprecated.  Please use other classes in System.Threading, such as Monitor, Mutex, Event, and Semaphore, to synchronize Threads or protect resources.  http://go.microsoft.com/fwlink/?linkid=14202", 
    false)]
[SecurityPermissionAttribute(SecurityAction::Demand, ControlThread = true)]
[SecurityPermissionAttribute(SecurityAction::Demand, ControlThread = true)]
public:
void Suspend()

JScript

public function Suspend()

Exceptions

Exception	Condition
ThreadStateException	The thread has not been started or is dead.
SecurityException	The caller does not have the appropriate SecurityPermission.

Remarks

If the thread is already suspended, this method has no effect.

Caution:
Do not use the Suspend and Resume methods to synchronize the activities of threads. You have no way of knowing what code a thread is executing when you suspend it. If you suspend a thread while it holds locks during a security permission evaluation, other threads in the AppDomain might be blocked. If you suspend a thread while it is executing a class constructor, other threads in the AppDomain that attempt to use that class are blocked. Deadlocks can occur very easily.

Caution:

Do not use the Suspend and Resume methods to synchronize the activities of threads. You have no way of knowing what code a thread is executing when you suspend it. If you suspend a thread while it holds locks during a security permission evaluation, other threads in the AppDomain might be blocked. If you suspend a thread while it is executing a class constructor, other threads in the AppDomain that attempt to use that class are blocked. Deadlocks can occur very easily.

.NET Framework Security

SecurityPermission
for advanced operations on threads. Associated enumeration: SecurityPermissionFlag..::.ControlThread.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

Version Information

.NET Framework

Supported in: 1.1, 1.0
Obsolete (compiler warning) in 3.5
Obsolete (compiler warning) in 3.5 SP1
Obsolete (compiler warning) in 3.0
Obsolete (compiler warning) in 3.0 SP1
Obsolete (compiler warning) in 3.0 SP2
Obsolete (compiler warning) in 2.0
Obsolete (compiler warning) in 2.0 SP1
Obsolete (compiler warning) in 2.0 SP2

Reference

Thread Class

Thread Members

System.Threading Namespace

Other Resources

Pausing and Resuming Threads

Managed Thread States