Sdílet prostřednictvím


Thread Konstruktory

Definice

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>

Platí pro