Thread Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci Thread třídy .
Přetížení
Thread(ParameterizedThreadStart) |
Inicializuje novou instanci Thread třídy zadáním delegáta, který umožňuje předání objektu vláknu při spuštění vlákna. |
Thread(ThreadStart) |
Inicializuje novou instanci Thread třídy . |
Thread(ParameterizedThreadStart, Int32) |
Inicializuje novou instanci Thread třídy zadáním delegáta, který umožňuje objekt předat vláknu při spuštění vlákna a zadat maximální velikost zásobníku pro vlákno. |
Thread(ThreadStart, Int32) |
Inicializuje novou instanci Thread třídy a určí maximální velikost zásobníku pro vlákno. |
Thread(ParameterizedThreadStart)
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
Inicializuje novou instanci Thread třídy zadáním delegáta, který umožňuje předání objektu vláknu při spuštění vlákna.
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
Delegát, který představuje metody, které mají být vyvolány při spuštění tohoto vlákna.
Výjimky
start
je null
.
Příklady
Následující příklad ukazuje syntaxi pro vytvoření a použití delegáta ParameterizedThreadStart se statickou metodou a metodou instance.
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.'
Poznámky
Vlákno se při vytvoření nezačne spouštět. Chcete-li naplánovat spuštění vlákna, zavolejte metodu Start . Chcete-li předat datový objekt vláknu, použijte Start(Object) přetížení metody.
Poznámka
Uživatelé jazyka ThreadStart Visual Basic mohou vynechat konstruktor při vytváření vlákna.
AddressOf
Při předávání metody použijte operátor , Dim t As New Thread(AddressOf ThreadProc)
například . Visual Basic automaticky volá ThreadStart konstruktor.
Viz také
Platí pro
Thread(ThreadStart)
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
Inicializuje novou instanci Thread třídy .
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
Delegát ThreadStart , který představuje metody, které mají být vyvolány při spuštění tohoto vlákna.
Výjimky
Parametr start
je null
.
Příklady
Následující příklad kódu ukazuje, jak vytvořit vlákno, které spouští statickou metodu.
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
Následující příklad kódu ukazuje, jak vytvořit vlákno, které spouští metodu instance.
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
Poznámky
Vlákno se při vytvoření nezačne spouštět. Chcete-li naplánovat spuštění vlákna, zavolejte metodu Start .
Poznámka
Uživatelé jazyka ThreadStart Visual Basic mohou vynechat konstruktor při vytváření vlákna.
AddressOf
Při předávání metody použijte operátor , Dim t As New Thread(AddressOf ThreadProc)
například . Visual Basic automaticky volá ThreadStart konstruktor.
Viz také
Platí pro
Thread(ParameterizedThreadStart, Int32)
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
Inicializuje novou instanci Thread třídy zadáním delegáta, který umožňuje objekt předat vláknu při spuštění vlákna a zadat maximální velikost zásobníku pro vlákno.
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
Delegát ParameterizedThreadStart , který představuje metody, které mají být vyvolány při spuštění tohoto vlákna.
- maxStackSize
- Int32
Maximální velikost zásobníku v bajtech, kterou má vlákno použít, nebo 0 pro použití výchozí maximální velikosti zásobníku zadané v hlavičce spustitelného souboru.
Důležité: U částečně důvěryhodného kódu se ignoruje, maxStackSize
pokud je větší než výchozí velikost zásobníku. Žádná výjimka se nevyvolá.
Výjimky
start
je null
.
Hodnota maxStackSize
je menší než nula.
Poznámky
Nepoužívejte toto přetížení konstruktoru. Výchozí velikost zásobníku Thread(ParameterizedThreadStart) používaná přetížením konstruktoru je doporučená velikost zásobníku pro vlákna. Pokud má vlákno problémy s pamětí, nejpravděpodobnější příčinou je chyba programování, například nekonečná rekurze.
Důležité
Počínaje rozhraním .NET Framework 4 lze pouze plně důvěryhodný kód nastavit maxStackSize
na hodnotu, která je větší než výchozí velikost zásobníku (1 megabajt). Pokud je pro maxStackSize
při spuštění kódu s částečnou důvěryhodností zadána větší hodnota, maxStackSize
je ignorována a použije se výchozí velikost zásobníku. Žádná výjimka se nevyvolá. Kód na jakékoli úrovni důvěryhodnosti lze nastavit maxStackSize
na hodnotu, která je menší než výchozí velikost zásobníku.
Poznámka
Pokud vyvíjíte plně důvěryhodnou knihovnu, která bude použita částečně důvěryhodným kódem, a potřebujete spustit vlákno, které vyžaduje velký zásobník, musíte před vytvořením vlákna potvrdit úplný vztah důvěryhodnosti, jinak se použije výchozí velikost zásobníku. Neuděláte to, pokud plně neřídíte kód, který běží ve vlákně.
Pokud maxStackSize
je menší než minimální velikost zásobníku, použije se minimální velikost zásobníku. Pokud maxStackSize
není násobek velikosti stránky, zaokrouhlí se na další větší násobek velikosti stránky.
Poznámka
Ve verzích Microsoft systému Windows starších než Windows XP a Windows Server 2003 maxStackSize
se ignoruje a použije se velikost zásobníku zadaná v hlavičce spustitelného souboru.
Pokud zadáte velmi malou velikost zásobníku, možná budete muset zakázat sondování přetečení zásobníku. Pokud je zásobník silně omezený, může sondování samo o sobě způsobit přetečení zásobníku. Pokud chcete zakázat testování přetečení zásobníku, přidejte do konfiguračního souboru aplikace v aplikaci .NET Framework následující kód.
<configuration>
<runtime>
<disableStackOverflowProbing enabled="true"/>
</runtime>
</configuration>
Platí pro
Thread(ThreadStart, Int32)
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
- Zdroj:
- Thread.cs
Inicializuje novou instanci Thread třídy a určí maximální velikost zásobníku pro vlákno.
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
Delegát ThreadStart , který představuje metody, které mají být vyvolány při spuštění tohoto vlákna.
- maxStackSize
- Int32
Maximální velikost zásobníku v bajtech, kterou má vlákno použít, nebo 0 pro použití výchozí maximální velikosti zásobníku zadané v hlavičce spustitelného souboru.
Důležité: U částečně důvěryhodného kódu se ignoruje, maxStackSize
pokud je větší než výchozí velikost zásobníku. Žádná výjimka se nevyvolá.
Výjimky
start
je null
.
Hodnota maxStackSize
je menší než nula.
Poznámky
Nepoužívejte toto přetížení konstruktoru. Výchozí velikost zásobníku Thread(ThreadStart) používaná přetížením konstruktoru je doporučená velikost zásobníku pro vlákna. Pokud má vlákno problémy s pamětí, nejpravděpodobnější příčinou je chyba programování, například nekonečná rekurze.
Důležité
Počínaje rozhraním .NET Framework 4 lze pouze plně důvěryhodný kód nastavit maxStackSize
na hodnotu, která je větší než výchozí velikost zásobníku (1 megabajt). Pokud je pro maxStackSize
při spuštění kódu s částečnou důvěryhodností zadána větší hodnota, maxStackSize
je ignorována a použije se výchozí velikost zásobníku. Žádná výjimka se nevyvolá. Kód na jakékoli úrovni důvěryhodnosti lze nastavit maxStackSize
na hodnotu, která je menší než výchozí velikost zásobníku.
Poznámka
Pokud vyvíjíte plně důvěryhodnou knihovnu, která bude použita částečně důvěryhodným kódem, a potřebujete spustit vlákno, které vyžaduje velký zásobník, musíte před vytvořením vlákna potvrdit úplný vztah důvěryhodnosti, jinak se použije výchozí velikost zásobníku. Neuděláte to, pokud plně neřídíte kód, který běží ve vlákně.
Pokud maxStackSize
je menší než minimální velikost zásobníku, použije se minimální velikost zásobníku. Pokud maxStackSize
není násobek velikosti stránky, zaokrouhlí se na další větší násobek velikosti stránky. Pokud například používáte rozhraní .NET Framework verze 2.0 v systému Windows Vista, je minimální velikost zásobníku 256 kB (262 144 bajtů) a velikost stránky je 64 kB (65 536 bajtů).
Poznámka
Ve verzích Microsoft systému Windows starších než Windows XP a Windows Server 2003 maxStackSize
se ignoruje a použije se velikost zásobníku zadaná v hlavičce spustitelného souboru.
Pokud zadáte velmi malou velikost zásobníku, možná budete muset zakázat sondování přetečení zásobníku. Pokud je zásobník silně omezený, může sondování samo o sobě způsobit přetečení zásobníku. Pokud chcete zakázat testování přetečení zásobníku, přidejte do konfiguračního souboru aplikace v aplikaci .NET Framework následující kód.
<configuration>
<runtime>
<disableStackOverflowProbing enabled="true"/>
</runtime>
</configuration>