Thread Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Źródło:
- Thread.cs
- Ź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
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ż
Dotyczy
Thread(ThreadStart)
- Źródło:
- Thread.cs
- Źródło:
- Thread.cs
- Ź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
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ż
Dotyczy
Thread(ParameterizedThreadStart, Int32)
- Źródło:
- Thread.cs
- Źródło:
- Thread.cs
- Ź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
start
to null
.
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>
Dotyczy
Thread(ThreadStart, Int32)
- Źródło:
- Thread.cs
- Źródło:
- Thread.cs
- Ź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
start
to null
.
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>