Thread Constructor (ThreadStart, Int32) (System.Threading)

Thread Constructor (ThreadStart, In...

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 Constructor (ThreadStart, Int32)

Updated: November 2007

Initializes a new instance of the Thread class, specifying the maximum stack size for the thread.

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

Syntax

Visual Basic (Declaration)

Public Sub New ( _
    start As ThreadStart, _
    maxStackSize As Integer _
)

Visual Basic (Usage)

Dim start As ThreadStart
Dim maxStackSize As Integer

Dim instance As New Thread(start, maxStackSize)

public Thread(
    ThreadStart start,
    int maxStackSize
)

Visual C++

public:
Thread(
    ThreadStart^ start, 
    int maxStackSize
)

public Thread(
    ThreadStart start,
    int maxStackSize
)

JScript

public function Thread(
    start : ThreadStart, 
    maxStackSize : int
)

Parameters

start: Type: System.Threading..::.ThreadStart
A ThreadStart delegate that represents the methods to be invoked when this thread begins executing.

maxStackSize: Type: System..::.Int32
The maximum stack size to be used by the thread, or 0 to use the default maximum stack size specified in the header for the executable.

Exceptions

Exception	Condition
ArgumentNullException	start is nullNothingnullptra null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	maxStackSize is less than zero.

Remarks

Avoid using this constructor overload. The default stack size used by the Thread(ThreadStart) constructor overload is the recommended stack size for threads. If a thread has memory problems, the most likely cause is programming error, such as infinite recursion.

If maxStackSize is less than the minimum stack size, the minimum stack size is used. If maxStackSize is not a multiple of the page size, it is rounded to the next larger multiple of the page size. For example, if you are using the .NET Framework version 2.0 on Microsoft Windows Vista, 256KB (262144 bytes) is the minimum stack size, and the page size is 64KB (65536 bytes).

Note:
On versions of Microsoft Windows prior to Windows XP and Windows Server 2003, maxStackSize is ignored, and the stack size specified in the executable header is used.

If you specify a very small stack size, you might need to disable stack-overflow probing. When the stack is severely constrained, the probing can itself cause a stack overflow. To disable stack overflow probing, add the following to your application configuration file.

<configuration>
  <runtime>
    <disableStackOverflowProbing enabled="true"/>
  </runtime>
</configuration>

Platforms

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

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