Thread Konstruktory

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.Thread.dll

Inicjuje nowe wystąpienie klasy Thread.

Przeciążenia

Thread(ParameterizedThreadStart)	Inicjuje Thread nowe wystąpienie klasy, określając delegata, który umożliwia przekazanie obiektu do wątku po uruchomieniu wątku.
Thread(ThreadStart)	Inicjuje nowe wystąpienie klasy Thread.
Thread(ParameterizedThreadStart, Int32)	Inicjuje Thread nowe wystąpienie klasy, określając delegata, który umożliwia przekazanie obiektu do wątku podczas uruchamiania wątku i określania maksymalnego rozmiaru stosu dla wątku.
Thread(ThreadStart, Int32)	Inicjuje Thread nowe wystąpienie klasy, określając maksymalny rozmiar stosu dla wątku.

Thread(ParameterizedThreadStart)

Źródło:

Thread.cs

Inicjuje Thread nowe wystąpienie klasy, określając delegata, który umożliwia przekazanie obiektu do wątku po uruchomieniu wątku.

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)

Parametry

start

ParameterizedThreadStart

Delegat reprezentujący metody, które mają być wywoływane po rozpoczęciu wykonywania tego wątku.

Wyjątki

ArgumentNullException

start to null.

Przykłady

Poniższy przykład przedstawia składnię tworzenia i używania delegata ParameterizedThreadStart z metodą statyczną i metodą wystąpienia.

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.'

Uwagi

Wątek nie rozpoczyna się wykonywania po jego utworzeniu. Aby zaplanować wątek do wykonania, wywołaj metodę Start . Aby przekazać obiekt danych do wątku, użyj Start(Object) przeciążenia metody.

Uwaga

Użytkownicy języka Visual Basic mogą pominąć ThreadStart konstruktora podczas tworzenia wątku. AddressOf Użyj operatora podczas przekazywania metody, na przykład Dim t As New Thread(AddressOf ThreadProc). Program Visual Basic automatycznie wywołuje ThreadStart konstruktor.

Zobacz też

• ParameterizedThreadStart
• Start
• AppDomain
• Tworzenie wątków

Thread(ThreadStart)

Źródło:

Thread.cs

Inicjuje nowe wystąpienie klasy 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)

Parametry

start

ThreadStart

Delegat ThreadStart reprezentujący metody, które mają być wywoływane po rozpoczęciu wykonywania tego wątku.

Wyjątki

ArgumentNullException

Parametr start ma wartość null.

Przykłady

Poniższy przykład kodu pokazuje, jak utworzyć wątek, który wykonuje metodę statyczną.

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

Poniższy przykład kodu pokazuje, jak utworzyć wątek, który wykonuje metodę wystąpienia.

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

Uwagi

Wątek nie rozpoczyna się wykonywania po jego utworzeniu. Aby zaplanować wątek do wykonania, wywołaj metodę Start .

Uwaga

Użytkownicy języka Visual Basic mogą pominąć ThreadStart konstruktora podczas tworzenia wątku. AddressOf Użyj operatora podczas przekazywania metody, na przykład Dim t As New Thread(AddressOf ThreadProc). Program Visual Basic automatycznie wywołuje ThreadStart konstruktor.

Zobacz też

• ThreadStart
• Start
• Tworzenie wątków

Thread(ParameterizedThreadStart, Int32)

Źródło:

Thread.cs

Inicjuje Thread nowe wystąpienie klasy, określając delegata, który umożliwia przekazanie obiektu do wątku podczas uruchamiania wątku i określania maksymalnego rozmiaru stosu dla wątku.

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)

Parametry

start

ParameterizedThreadStart

Delegat ParameterizedThreadStart reprezentujący metody, które mają być wywoływane po rozpoczęciu wykonywania tego wątku.

maxStackSize

Int32

Maksymalny rozmiar stosu (w bajtach) używany przez wątek lub 0 do użycia domyślnego maksymalnego rozmiaru stosu określonego w nagłówku pliku wykonywalnego.

Ważne w przypadku częściowo zaufanego kodu jest ignorowane, maxStackSize jeśli jest większy niż domyślny rozmiar stosu. Wyjątek nie jest zgłaszany.

Wyjątki

ArgumentNullException

start to null.

ArgumentOutOfRangeException

Parametr maxStackSize ma wartość niższą niż zero.

Uwagi

Unikaj używania tego przeciążenia konstruktora. Domyślny rozmiar stosu używany przez przeciążenie konstruktora jest zalecanym rozmiarem Thread(ParameterizedThreadStart) stosu dla wątków. Jeśli wątek ma problemy z pamięcią, najbardziej prawdopodobną przyczyną jest błąd programowania, taki jak nieskończona rekursja.

Ważne

Począwszy od .NET Framework 4, tylko w pełni zaufany kod może ustawić maxStackSize wartość większą niż domyślny rozmiar stosu (1 megabajt). Jeśli zostanie określona maxStackSize większa wartość, gdy kod jest uruchomiony z częściowym zaufaniem, maxStackSize zostanie zignorowany i zostanie użyty domyślny rozmiar stosu. Wyjątek nie jest zgłaszany. Kod na dowolnym poziomie zaufania może być ustawiony maxStackSize na wartość mniejszą niż domyślny rozmiar stosu.

Uwaga

Jeśli tworzysz w pełni zaufaną bibliotekę, która będzie używana przez częściowo zaufany kod i musisz uruchomić wątek, który wymaga dużego stosu, musisz zapewnić pełne zaufanie przed utworzeniem wątku lub będzie używany domyślny rozmiar stosu. Nie należy tego robić, chyba że w pełni kontrolujesz kod uruchamiany w wątku.

Jeśli maxStackSize jest mniejszy niż minimalny rozmiar stosu, zostanie użyty minimalny rozmiar stosu. Jeśli maxStackSize rozmiar strony nie jest wielokrotny, zostanie zaokrąglony do kolejnej większej wielokrotności rozmiaru strony.

Uwaga

W wersjach systemu Microsoft Windows wcześniejszych niż Windows XP i Windows Server 2003 maxStackSize jest ignorowany, a rozmiar stosu określony w nagłówku pliku wykonywalnego jest używany.

Jeśli określisz bardzo mały rozmiar stosu, może być konieczne wyłączenie sondowania przepełnienia stosu. Gdy stos jest poważnie ograniczony, sondowanie może spowodować przepełnienie stosu. Aby wyłączyć sondowanie przepełnienia stosu, dodaj następujący kod do pliku konfiguracji aplikacji w aplikacji .NET Framework.

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

Thread(ThreadStart, Int32)

Źródło:

Thread.cs

Inicjuje Thread nowe wystąpienie klasy, określając maksymalny rozmiar stosu dla wątku.

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)

Parametry

start

ThreadStart

Delegat ThreadStart reprezentujący metody, które mają być wywoływane po rozpoczęciu wykonywania tego wątku.

maxStackSize

Int32

Maksymalny rozmiar stosu (w bajtach) używany przez wątek lub 0 do użycia domyślnego maksymalnego rozmiaru stosu określonego w nagłówku pliku wykonywalnego.

Ważne w przypadku częściowo zaufanego kodu jest ignorowane, maxStackSize jeśli jest większy niż domyślny rozmiar stosu. Wyjątek nie jest zgłaszany.

Wyjątki

ArgumentNullException

start to null.

ArgumentOutOfRangeException

Parametr maxStackSize ma wartość niższą niż zero.

Uwagi

Unikaj używania tego przeciążenia konstruktora. Domyślny rozmiar stosu używany przez przeciążenie konstruktora jest zalecanym rozmiarem Thread(ThreadStart) stosu dla wątków. Jeśli wątek ma problemy z pamięcią, najbardziej prawdopodobną przyczyną jest błąd programowania, taki jak nieskończona rekursja.

Ważne

Począwszy od .NET Framework 4, tylko w pełni zaufany kod może ustawić maxStackSize wartość większą niż domyślny rozmiar stosu (1 megabajt). Jeśli zostanie określona maxStackSize większa wartość, gdy kod jest uruchomiony z częściowym zaufaniem, maxStackSize zostanie zignorowany i zostanie użyty domyślny rozmiar stosu. Wyjątek nie jest zgłaszany. Kod na dowolnym poziomie zaufania może być ustawiony maxStackSize na wartość mniejszą niż domyślny rozmiar stosu.

Uwaga

Jeśli tworzysz w pełni zaufaną bibliotekę, która będzie używana przez częściowo zaufany kod i musisz uruchomić wątek, który wymaga dużego stosu, musisz zapewnić pełne zaufanie przed utworzeniem wątku lub będzie używany domyślny rozmiar stosu. Nie należy tego robić, chyba że w pełni kontrolujesz kod uruchamiany w wątku.

Jeśli maxStackSize jest mniejszy niż minimalny rozmiar stosu, zostanie użyty minimalny rozmiar stosu. Jeśli maxStackSize rozmiar strony nie jest wielokrotny, zostanie zaokrąglony do kolejnej większej wielokrotności rozmiaru strony. Jeśli na przykład używasz .NET Framework w wersji 2.0 w systemie Windows Vista, 256 KB (262 144 bajtów) jest minimalnym rozmiarem stosu, a rozmiar strony to 64 KB (65 536 bajtów).

Uwaga

W wersjach systemu Microsoft Windows wcześniejszych niż Windows XP i Windows Server 2003 maxStackSize jest ignorowany, a rozmiar stosu określony w nagłówku pliku wykonywalnego jest używany.

Jeśli określisz bardzo mały rozmiar stosu, może być konieczne wyłączenie sondowania przepełnienia stosu. Gdy stos jest poważnie ograniczony, sondowanie może spowodować przepełnienie stosu. Aby wyłączyć sondowanie przepełnienia stosu, dodaj następujący kod do pliku konfiguracji aplikacji w aplikacji .NET Framework.

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