Поделиться через


Thread Конструкторы

Определение

Инициализирует новый экземпляр класса Thread.

Перегрузки

Thread(ParameterizedThreadStart)

Инициализирует новый экземпляр класса Thread, при этом указывается делегат, позволяющий объекту быть переданным в поток при запуске потока.

Thread(ThreadStart)

Инициализирует новый экземпляр класса Thread.

Thread(ParameterizedThreadStart, Int32)

Инициализирует новый экземпляр класса Thread, при этом указывается делегат, позволяющий объекту быть переданным в поток при запуске потока с указанием максимального размера стека для потока.

Thread(ThreadStart, Int32)

Инициализирует новый экземпляр класса Thread, указывая максимальный размер стека для потока.

Thread(ParameterizedThreadStart)

Исходный код:
Thread.cs
Исходный код:
Thread.cs
Исходный код:
Thread.cs

Инициализирует новый экземпляр класса Thread, при этом указывается делегат, позволяющий объекту быть переданным в поток при запуске потока.

public:
 Thread(System::Threading::ParameterizedThreadStart ^ start);
public Thread (System.Threading.ParameterizedThreadStart start);
new System.Threading.Thread : System.Threading.ParameterizedThreadStart -> System.Threading.Thread
Public Sub New (start As ParameterizedThreadStart)

Параметры

start
ParameterizedThreadStart

Делегат, указывающий на методы, которые вызываются при запуске потока.

Исключения

start имеет значение null.

Примеры

В следующем примере показан синтаксис для создания и использования делегата ParameterizedThreadStart со статическим методом и методом экземпляра.

using namespace System;
using namespace System::Threading;

namespace SystemThreadingExample
{
    public ref class Work
    {
    public:
        void StartThreads()
        {
            // Start a thread that calls a parameterized static method.
            Thread^ newThread = gcnew
                Thread(gcnew ParameterizedThreadStart(Work::DoWork));
            newThread->Start(42);
              
            // Start a thread that calls a parameterized instance method.
            Work^ someWork = gcnew Work;
            newThread = gcnew Thread(
                        gcnew ParameterizedThreadStart(someWork,
                        &Work::DoMoreWork));
            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 example displays output like the following:
//       Static thread procedure. Data='42'
//       Instance thread procedure. Data='The answer.'
using System;
using System.Threading;

public class Work
{
    public static void Main()
    {
        // Start a thread that calls a parameterized static method.
        Thread newThread = new Thread(Work.DoWork);
        newThread.Start(42);

        // Start a thread that calls a parameterized instance method.
        Work w = new Work();
        newThread = new Thread(w.DoMoreWork);
        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 example displays output like the following:
//       Static thread procedure. Data='42'
//       Instance thread procedure. Data='The answer.'
open System.Threading

type Work() =
    static member DoWork(data: obj) =
        printfn $"Static thread procedure. Data='{data}'"

    member _.DoMoreWork(data: obj) =
        printfn $"Instance thread procedure. Data='{data}'"

// Start a thread that calls a parameterized static method.
let newThread = Thread(ParameterizedThreadStart Work.DoWork)
newThread.Start 42

// Start a thread that calls a parameterized instance method.
let w = Work()
let newThread2 = Thread(ParameterizedThreadStart w.DoMoreWork)
newThread.Start "The answer."

// This example displays output like the following:
//       Static thread procedure. Data='42'
//       Instance thread procedure. Data='The answer.'
Imports System.Threading

Public Class Work
    Shared Sub Main()
        ' Start a thread that calls a parameterized static method.
        Dim newThread As New Thread(AddressOf Work.DoWork)
        newThread.Start(42)

        ' Start a thread that calls a parameterized instance method.
        Dim w As New Work()
        newThread = New Thread(AddressOf w.DoMoreWork)
        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 example displays output like the following:
'    Static thread procedure. Data='42'
'    Instance thread procedure. Data='The answer.'

Комментарии

Поток не начинает выполняться при его создании. Чтобы запланировать выполнение потока, вызовите Start метод . Чтобы передать объект данных в поток, используйте перегрузку Start(Object) метода .

Примечание

Пользователи Visual Basic могут пропускать ThreadStart конструктор при создании потока. AddressOf Используйте оператор при передаче метода, например Dim t As New Thread(AddressOf ThreadProc). Visual Basic автоматически вызывает ThreadStart конструктор.

См. также раздел

Применяется к

Thread(ThreadStart)

Исходный код:
Thread.cs
Исходный код:
Thread.cs
Исходный код:
Thread.cs

Инициализирует новый экземпляр класса Thread.

public:
 Thread(System::Threading::ThreadStart ^ start);
public Thread (System.Threading.ThreadStart start);
new System.Threading.Thread : System.Threading.ThreadStart -> System.Threading.Thread
Public Sub New (start As ThreadStart)

Параметры

start
ThreadStart

Делегат ThreadStart, указывающий на методы, которые вызываются при запуске потока.

Исключения

Параметр start имеет значение null.

Примеры

В следующем примере кода показано, как создать поток, который выполняет статический метод.

using namespace System;
using namespace System::Threading;
ref class Work
{
private:
   Work(){}


public:
   static void DoWork(){}

};

int main()
{
   Thread^ newThread = gcnew Thread( gcnew ThreadStart( &Work::DoWork ) );
   newThread->Start();
}
using System;
using System.Threading;

class Test
{
    static void Main() 
    {
        Thread newThread = 
            new Thread(new ThreadStart(Work.DoWork));
        newThread.Start();
    }
}

class Work 
{
    Work() {}

    public static void DoWork() {}
}
open System.Threading

module Work =
    let doWork () = ()

let newThread = Thread(ThreadStart Work.doWork)
newThread.Start()
Imports System.Threading

Public Class Test
    <MTAThread> _
    Shared Sub Main()
        Dim newThread As New Thread(AddressOf Work.DoWork)
        newThread.Start()
    End Sub
End Class

Public Class Work 

    Private Sub New()
    End Sub

    Shared Sub DoWork()
    End Sub

End Class

В следующем примере кода показано, как создать поток, который выполняет метод экземпляра.

using namespace System;
using namespace System::Threading;
ref class Work
{
public:
   Work(){}

   void DoWork(){}

};

int main()
{
   Work^ threadWork = gcnew Work;
   Thread^ newThread = gcnew Thread( gcnew ThreadStart( threadWork, &Work::DoWork ) );
   newThread->Start();
}
using System;
using System.Threading;

class Test
{
    static void Main() 
    {
        Work threadWork = new Work();
        Thread newThread = 
            new Thread(new ThreadStart(threadWork.DoWork));
        newThread.Start();
    }
}

class Work 
{
    public Work() {}

    public void DoWork() {}
}
open System.Threading

type Work() =
    member _.DoWork() = ()

let threadWork = Work()
let newThread = Thread(ThreadStart threadWork.DoWork)
newThread.Start()
Imports System.Threading

Public Class Test
    <MTAThread> _
    Shared Sub Main() 
        Dim threadWork As New Work()
        Dim newThread As New Thread(AddressOf threadWork.DoWork)
        newThread.Start()
    End Sub
End Class

Public Class Work

    Sub New()
    End Sub

    Sub DoWork() 
    End Sub

End Class

Комментарии

Поток не начинает выполняться при его создании. Чтобы запланировать выполнение потока, вызовите Start метод .

Примечание

Пользователи Visual Basic могут пропускать ThreadStart конструктор при создании потока. AddressOf Используйте оператор при передаче метода, например Dim t As New Thread(AddressOf ThreadProc). Visual Basic автоматически вызывает ThreadStart конструктор.

См. также раздел

Применяется к

Thread(ParameterizedThreadStart, Int32)

Исходный код:
Thread.cs
Исходный код:
Thread.cs
Исходный код:
Thread.cs

Инициализирует новый экземпляр класса Thread, при этом указывается делегат, позволяющий объекту быть переданным в поток при запуске потока с указанием максимального размера стека для потока.

public:
 Thread(System::Threading::ParameterizedThreadStart ^ start, int maxStackSize);
public Thread (System.Threading.ParameterizedThreadStart start, int maxStackSize);
new System.Threading.Thread : System.Threading.ParameterizedThreadStart * int -> System.Threading.Thread
Public Sub New (start As ParameterizedThreadStart, maxStackSize As Integer)

Параметры

start
ParameterizedThreadStart

Делегат ParameterizedThreadStart, указывающий на методы, которые вызываются при запуске потока.

maxStackSize
Int32

Максимальный размер стека в байтах, используемый потоком, или же 0 для использования максимального размера по умолчанию, указывается в заголовке исполняемого файла.

Важно! Для частично доверенного кода игнорируется, maxStackSize если он больше размера стека по умолчанию. Исключение не выдается.

Исключения

start имеет значение null.

Значение параметра maxStackSize меньше нуля.

Комментарии

Избегайте использования этой перегрузки конструктора. Размер стека по умолчанию, используемый перегрузкой Thread(ParameterizedThreadStart) конструктора, — это рекомендуемый размер стека для потоков. Если поток имеет проблемы с памятью, наиболее вероятной причиной является ошибка программирования, например бесконечная рекурсия.

Важно!

Начиная с платформа .NET Framework 4, только полностью доверенный код может задать maxStackSize значение, превышающее размер стека по умолчанию (1 мегабайт). Если указано большее значение для , maxStackSize когда код выполняется с частичным доверием, maxStackSize игнорируется и используется размер стека по умолчанию. Исключение не выдается. Код на любом уровне доверия может задать maxStackSize значение, которое меньше размера стека по умолчанию.

Примечание

Если вы разрабатываете полностью доверенную библиотеку, которая будет использоваться частично доверенным кодом, и необходимо запустить поток, требующий большого стека, необходимо подтвердить полное доверие перед созданием потока, иначе будет использоваться размер стека по умолчанию. Не делайте этого, если вы не полностью контролируете код, который выполняется в потоке.

Если maxStackSize меньше минимального размера стека, используется минимальный размер стека. Если maxStackSize значение не кратно размеру страницы, оно округляется до следующего большего размера страницы.

Примечание

В версиях Майкрософт Windows, предшествующих Windows XP и Windows Server 2003, maxStackSize игнорируется, и используется размер стека, указанный в заголовке исполняемого файла.

Если указать очень небольшой размер стека, может потребоваться отключить стек переполнения. Если стек сильно ограничен, само по себе зондирование может привести к переполнению стека. Чтобы отключить стек переполнения, добавьте следующий код в файл конфигурации приложения в платформа .NET Framework приложении.

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

Применяется к

Thread(ThreadStart, Int32)

Исходный код:
Thread.cs
Исходный код:
Thread.cs
Исходный код:
Thread.cs

Инициализирует новый экземпляр класса Thread, указывая максимальный размер стека для потока.

public:
 Thread(System::Threading::ThreadStart ^ start, int maxStackSize);
public Thread (System.Threading.ThreadStart start, int maxStackSize);
new System.Threading.Thread : System.Threading.ThreadStart * int -> System.Threading.Thread
Public Sub New (start As ThreadStart, maxStackSize As Integer)

Параметры

start
ThreadStart

Делегат ThreadStart, указывающий на методы, которые вызываются при запуске потока.

maxStackSize
Int32

Максимальный размер стека в байтах, используемый потоком, или же 0 для использования максимального размера по умолчанию, указывается в заголовке исполняемого файла.

Важно! Для частично доверенного кода игнорируется, maxStackSize если он больше размера стека по умолчанию. Исключение не выдается.

Исключения

start имеет значение null.

Значение параметра maxStackSize меньше нуля.

Комментарии

Избегайте использования этой перегрузки конструктора. Размер стека по умолчанию, используемый перегрузкой Thread(ThreadStart) конструктора, — это рекомендуемый размер стека для потоков. Если поток имеет проблемы с памятью, наиболее вероятной причиной является ошибка программирования, например бесконечная рекурсия.

Важно!

Начиная с платформа .NET Framework 4, только полностью доверенный код может задать maxStackSize значение, превышающее размер стека по умолчанию (1 мегабайт). Если указано большее значение для , maxStackSize когда код выполняется с частичным доверием, maxStackSize игнорируется и используется размер стека по умолчанию. Исключение не выдается. Код на любом уровне доверия может задать maxStackSize значение, которое меньше размера стека по умолчанию.

Примечание

Если вы разрабатываете полностью доверенную библиотеку, которая будет использоваться частично доверенным кодом, и необходимо запустить поток, требующий большого стека, необходимо подтвердить полное доверие перед созданием потока, иначе будет использоваться размер стека по умолчанию. Не делайте этого, если вы не полностью контролируете код, который выполняется в потоке.

Если maxStackSize меньше минимального размера стека, используется минимальный размер стека. Если maxStackSize значение не кратно размеру страницы, оно округляется до следующего большего размера страницы. Например, если вы используете платформа .NET Framework версии 2.0 в Windows Vista, 256 КБ (262 144 байта) — это минимальный размер стека, а размер страницы — 64 КБ (65 536 байт).

Примечание

В версиях Майкрософт Windows, предшествующих Windows XP и Windows Server 2003, maxStackSize игнорируется, и используется размер стека, указанный в заголовке исполняемого файла.

Если указать очень небольшой размер стека, может потребоваться отключить стек переполнения. Если стек сильно ограничен, само по себе зондирование может привести к переполнению стека. Чтобы отключить стек переполнения, добавьте следующий код в файл конфигурации приложения в платформа .NET Framework приложении.

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

Применяется к