Note: This method is new in the .NET Framework version 2.0.
Causes the operating system to change the state of the current instance to
ThreadState.Running, and optionally supplies an object containing data to be used by the method the thread executes.
Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)
Visual Basic (Declaration)
Public Sub Start ( _
parameter As Object _
)
Dim instance As Thread
Dim parameter As Object
instance.Start(parameter)
public void Start (
Object parameter
)
public:
void Start (
Object^ parameter
)
public void Start (
Object parameter
)
public function Start (
parameter : Object
)
Parameters
- parameter
An object that contains data to be used by the method the thread executes.
Once a thread is in the ThreadState.Running state, the operating system can schedule it for execution. The thread begins executing at the first line of the method represented by the ThreadStart or ParameterizedThreadStart delegate supplied to the thread constructor.
Once the thread terminates, it cannot be restarted with another call to Start.
This overload and the ParameterizedThreadStart delegate make it easy to pass data to a thread procedure, but the technique is not type safe because any object can be passed to this overload. A more robust way to pass data to a thread procedure is to put both the thread procedure and the data fields into a worker object. For more information, see Creating Threads and Passing Data at Start Time.
The following code example shows the syntax for creating and using a ParameterizedThreadStart delegate with a static method and an instance method.
Imports System
Imports System.Threading
Public Class Work
<MTAThread> _
Shared Sub Main()
' To start a thread using a shared thread procedure, use
' the class name and method name when you create the
' ParameterizedThreadStart delegate. Visual Basic expands
' the AddressOf expression to the appropriate delegate
' creation syntax:
' New ParameterizedThreadStart(AddressOf Work.DoWork)
'
Dim newThread As New Thread(AddressOf Work.DoWork)
' Use the overload of the Start method that has a
' parameter of type Object. You can create an object that
' contains several pieces of data, or you can pass any
' object or value type. The following code passes the
' integer value 42.
'
newThread.Start(42)
' To start a thread using an instance method for the thread
' procedure, use the instance variable and method name when
' you create the ParameterizedThreadStart delegate. Visual
' Basic expands the AddressOf expression to the appropriate
' delegate creation syntax:
' New ParameterizedThreadStart(AddressOf w.DoMoreWork)
'
Dim w As New Work()
newThread = New Thread(New ParameterizedThreadStart(AddressOf w.DoMoreWork))
'newThread = New Thread(AddressOf w.DoMoreWork)
' Pass an object containing data for the thread.
'
newThread.Start("The answer.")
End Sub
Public Shared Sub DoWork(ByVal data As Object)
Console.WriteLine("Static thread procedure. Data='{0}'", _
data)
End Sub
Public Sub DoMoreWork(ByVal data As Object)
Console.WriteLine("Instance thread procedure. Data='{0}'", _
data)
End Sub
End Class
' This code example produces the following output (the order
' of the lines might vary):
'
'Static thread procedure. Data='42'
'Instance thread procedure. Data='The answer'
using System;
using System.Threading;
public class Work
{
public static void Main()
{
// To start a thread using a shared thread procedure, use
// the class name and method name when you create the
// ParameterizedThreadStart delegate.
//
Thread newThread = new Thread(
new ParameterizedThreadStart(Work.DoWork));
// Use the overload of the Start method that has a
// parameter of type Object. You can create an object that
// contains several pieces of data, or you can pass any
// reference type or value type. The following code passes
// the integer value 42.
//
newThread.Start(42);
// To start a thread using an instance method for the thread
// procedure, use the instance variable and method name when
// you create the ParameterizedThreadStart delegate.
//
Work w = new Work();
newThread = new Thread(
new ParameterizedThreadStart(w.DoMoreWork));
// Pass an object containing data for the thread.
//
newThread.Start("The answer.");
}
public static void DoWork(object data)
{
Console.WriteLine("Static thread procedure. Data='{0}'",
data);
}
public void DoMoreWork(object data)
{
Console.WriteLine("Instance thread procedure. Data='{0}'",
data);
}
}
/* This code example produces the following output (the order
of the lines might vary):
Static thread procedure. Data='42'
Instance thread procedure. Data='The answer'
*/
using namespace System;
using namespace System::Threading;
namespace SystemThreadingExample
{
public ref class Work
{
public:
void StartThreads()
{
// To start a thread using a shared thread procedure, use
// the class name and method name when you create the
// ParameterizedThreadStart delegate.
// AddressOf Work.DoWork)
//
Thread^ newThread = gcnew
Thread(gcnew ParameterizedThreadStart(Work::DoWork));
// Use the overload of the Start method that has a
// parameter of type Object. You can create an object that
// contains several pieces of data, or you can pass any
// reference type or value type. The following code passes
// the integer value 42.
newThread->Start(42);
// To start a thread using an instance method for the thread
// procedure, use the instance variable and method name when
// you create the ParameterizedThreadStart delegate.
Work^ someWork = gcnew Work;
newThread =
gcnew Thread(
gcnew ParameterizedThreadStart(someWork,
&Work::DoMoreWork));
// Pass an object containing data for the thread.
//
newThread->Start("The answer.");
}
static void DoWork(Object^ data)
{
Console::WriteLine("Static thread procedure. Data='{0}'",
data);
}
void DoMoreWork(Object^ data)
{
Console::WriteLine("Instance thread procedure. Data='{0}'",
data);
}
};
}
//Entry point of example application
int main()
{
SystemThreadingExample::Work^ samplework =
gcnew SystemThreadingExample::Work();
samplework->StartThreads();
}
// This code example produces the following output (the order
// of the lines might vary):
// Static thread procedure. Data='42'
// Instance thread procedure. Data='The answer'
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
.NET Framework
Supported in: 2.0