Thread Konstruktory

Definice

Inicializuje novou instanci třídy Thread.Initializes a new instance of the Thread class.

Přetížení

Thread(ParameterizedThreadStart)

Inicializuje novou instanci třídy Thread a určí delegáta, který umožňuje předání objektu do vlákna při spuštění vlákna.Initializes a new instance of the Thread class, specifying a delegate that allows an object to be passed to the thread when the thread is started.

Thread(ThreadStart)

Inicializuje novou instanci třídy Thread.Initializes a new instance of the Thread class.

Thread(ParameterizedThreadStart, Int32)

Inicializuje novou instanci třídy Thread, určení delegáta, který umožňuje předání objektu do vlákna při spuštění vlákna a určení maximální velikosti zásobníku pro vlákno.Initializes a new instance of the Thread class, specifying a delegate that allows an object to be passed to the thread when the thread is started and specifying the maximum stack size for the thread.

Thread(ThreadStart, Int32)

Inicializuje novou instanci třídy Thread a určí maximální velikost zásobníku pro vlákno.Initializes a new instance of the Thread class, specifying the maximum stack size for the thread.

Thread(ParameterizedThreadStart)

Inicializuje novou instanci třídy Thread a určí delegáta, který umožňuje předání objektu do vlákna při spuštění vlákna.Initializes a new instance of the Thread class, specifying a delegate that allows an object to be passed to the thread when the thread is started.

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.A delegate that represents the methods to be invoked when this thread begins executing.

Výjimky

start je null.start is 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.The following example shows the syntax for creating and using a ParameterizedThreadStart delegate with a static method and an instance method.

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.'
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 nezačíná vykonání při jeho vytvoření.A thread does not begin executing when it is created. Chcete-li naplánovat spuštění vlákna, zavolejte metodu Start.To schedule the thread for execution, call the Start method. Chcete-li předat datový objekt do vlákna, použijte přetížení metody Start(Object).To pass a data object to the thread, use the Start(Object) method overload.

Poznámka

Visual Basic uživatelé mohou při vytváření vlákna vynechat konstruktor ThreadStart.Visual Basic users can omit the ThreadStart constructor when creating a thread. Při předávání metody použijte operátor AddressOf, například Dim t As New Thread(AddressOf ThreadProc).Use the AddressOf operator when passing your method, for example Dim t As New Thread(AddressOf ThreadProc). Visual Basic automaticky volá konstruktor ThreadStart.Visual Basic automatically calls the ThreadStart constructor.

Viz také

Thread(ThreadStart)

Inicializuje novou instanci třídy Thread.Initializes a new instance of the Thread class.

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

ThreadStart delegát, který představuje metody, které mají být vyvolány, když toto vlákno začne spouštět.A ThreadStart delegate that represents the methods to be invoked when this thread begins executing.

Výjimky

Parametr start má hodnotu null.The start parameter is null.

Příklady

Následující příklad kódu ukazuje, jak vytvořit vlákno, které provádí statickou metodu.The following code example shows how to create a thread that executes a static method.

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() {}
}
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.The following code example shows how to create a thread that executes an instance method.

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() {}
}
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 nezačíná vykonání při jeho vytvoření.A thread does not begin executing when it is created. Chcete-li naplánovat spuštění vlákna, zavolejte metodu Start.To schedule the thread for execution, call the Start method.

Poznámka

Visual Basic uživatelé mohou při vytváření vlákna vynechat konstruktor ThreadStart.Visual Basic users can omit the ThreadStart constructor when creating a thread. Použijte operátor AddressOf při předávání metody například Dim t As New Thread(AddressOf ThreadProc).Use the AddressOf operator when passing your method for example Dim t As New Thread(AddressOf ThreadProc). Visual Basic automaticky volá konstruktor ThreadStart.Visual Basic automatically calls the ThreadStart constructor.

Viz také

Thread(ParameterizedThreadStart, Int32)

Inicializuje novou instanci třídy Thread, určení delegáta, který umožňuje předání objektu do vlákna při spuštění vlákna a určení maximální velikosti zásobníku pro vlákno.Initializes a new instance of the Thread class, specifying a delegate that allows an object to be passed to the thread when the thread is started and specifying the maximum stack size for the 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)

Parametry

start
ParameterizedThreadStart

ParameterizedThreadStart delegát, který představuje metody, které mají být vyvolány, když toto vlákno začne spouštět.A ParameterizedThreadStart delegate that represents the methods to be invoked when this thread begins executing.

maxStackSize
Int32

Maximální velikost zásobníku (v bajtech), která má být použita vláknem, nebo 0 pro použití výchozí maximální velikosti zásobníku určenou v záhlaví spustitelného souboru.The maximum stack size, in bytes, to be used by the thread, or 0 to use the default maximum stack size specified in the header for the executable.

Důležité pro částečně důvěryhodný kód, maxStackSize se ignoruje, pokud je větší než výchozí velikost zásobníku.Important For partially trusted code, maxStackSize is ignored if it is greater than the default stack size. Není vyvolána žádná výjimka.No exception is thrown.

Výjimky

start je null.start is null.

Hodnota maxStackSize je menší než nula.maxStackSize is less than zero.

Poznámky

Nepoužívejte toto přetížení konstruktoru.Avoid using this constructor overload. Výchozí velikost zásobníku používaná přetížením konstruktoru Thread(ParameterizedThreadStart) je doporučená velikost zásobníku pro vlákna.The default stack size used by the Thread(ParameterizedThreadStart) constructor overload is the recommended stack size for threads. Pokud má vlákno problémy s pamětí, nejpravděpodobnější příčinou je chyba programování, například nekonečné rekurze.If a thread has memory problems, the most likely cause is programming error, such as infinite recursion.

Důležité

Počínaje .NET Framework 4.NET Framework 4může pouze plně důvěryhodný kód nastavit maxStackSize na hodnotu, která je větší než výchozí velikost zásobníku (1 megabajt).Beginning with the .NET Framework 4.NET Framework 4, only fully trusted code can set maxStackSize to a value that is greater than the default stack size (1 megabyte). Pokud je zadaná větší hodnota pro maxStackSize, když je kód spuštěný s částečnou důvěryhodností, maxStackSize se ignoruje a použije se výchozí velikost zásobníku.If a larger value is specified for maxStackSize when code is running with partial trust, maxStackSize is ignored and the default stack size is used. Není vyvolána žádná výjimka.No exception is thrown. Kód na libovolné úrovni vztahu důvěryhodnosti může nastavit maxStackSize na hodnotu, která je menší než výchozí velikost zásobníku.Code at any trust level can set maxStackSize to a value that is less than the default stack size.

Poznámka

Pokud vyvíjíte plně důvěryhodnou knihovnu, která bude používána částečně důvěryhodným kódem, a potřebujete spustit vlákno, které vyžaduje velký zásobník, je nutné před vytvořením vlákna uplatnit úplný vztah důvěryhodnosti, nebo bude použita výchozí velikost zásobníku.If you are developing a fully trusted library that will be used by partially trusted code, and you need to start a thread that requires a large stack, you must assert full trust before creating the thread, or the default stack size will be used. Tento postup neprovádějte, pokud plně neovládáte kód, který je spuštěn ve vlákně.Do not do this unless you fully control the code that runs on the thread.

Pokud je maxStackSize menší než minimální velikost zásobníku, použije se minimální velikost zásobníku.If maxStackSize is less than the minimum stack size, the minimum stack size is used. Pokud maxStackSize není násobkem velikosti stránky, zaokrouhlí se na další větší násobek velikosti stránky.If maxStackSize is not a multiple of the page size, it is rounded to the next larger multiple of the page size. Pokud například používáte .NET Framework verze 2,0 v systému Windows Vista, je minimální velikost zásobníku 256KB (262 144 bajtů) a velikost stránky je 64 kB (65 536 bajtů).For example, if you are using the .NET Framework version 2.0 on Windows Vista, 256KB (262,144 bytes) is the minimum stack size, and the page size is 64KB (65,536 bytes).

Poznámka

Ve verzích systému Microsoft Windows starších než Windows XP a Windows Server 2003 se maxStackSize ignoruje a je použita velikost zásobníku zadaná v záhlaví spustitelného souboru.On versions of Microsoft Windows prior to Windows XP and Windows Server 2003, maxStackSize is ignored, and the stack size specified in the executable header is used.

Pokud zadáte velmi malou velikost zásobníku, možná budete muset zakázat zjišťování přetečení zásobníku.If you specify a very small stack size, you might need to disable stack-overflow probing. Pokud je zásobník vážně omezený, může zjišťování způsobit přetečení zásobníku.When the stack is severely constrained, the probing can itself cause a stack overflow. Chcete-li zakázat zjišťování přetečení zásobníku, přidejte následující do konfiguračního souboru aplikace.To disable stack overflow probing, add the following to your application configuration file.

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

Thread(ThreadStart, Int32)

Inicializuje novou instanci třídy Thread a určí maximální velikost zásobníku pro vlákno.Initializes a new instance of the Thread class, specifying the maximum stack size for the 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)

Parametry

start
ThreadStart

ThreadStart delegát, který představuje metody, které mají být vyvolány, když toto vlákno začne spouštět.A ThreadStart delegate that represents the methods to be invoked when this thread begins executing.

maxStackSize
Int32

Maximální velikost zásobníku (v bajtech), která má být použita vláknem, nebo 0 pro použití výchozí maximální velikosti zásobníku určenou v záhlaví spustitelného souboru.The maximum stack size, in bytes, to be used by the thread, or 0 to use the default maximum stack size specified in the header for the executable.

Důležité pro částečně důvěryhodný kód, maxStackSize se ignoruje, pokud je větší než výchozí velikost zásobníku.Important For partially trusted code, maxStackSize is ignored if it is greater than the default stack size. Není vyvolána žádná výjimka.No exception is thrown.

Výjimky

start je null.start is null.

Hodnota maxStackSize je menší než nula.maxStackSize is less than zero.

Poznámky

Nepoužívejte toto přetížení konstruktoru.Avoid using this constructor overload. Výchozí velikost zásobníku používaná přetížením konstruktoru Thread(ThreadStart) je doporučená velikost zásobníku pro vlákna.The default stack size used by the Thread(ThreadStart) constructor overload is the recommended stack size for threads. Pokud má vlákno problémy s pamětí, nejpravděpodobnější příčinou je chyba programování, například nekonečné rekurze.If a thread has memory problems, the most likely cause is programming error, such as infinite recursion.

Důležité

Počínaje .NET Framework 4.NET Framework 4může pouze plně důvěryhodný kód nastavit maxStackSize na hodnotu, která je větší než výchozí velikost zásobníku (1 megabajt).Beginning with the .NET Framework 4.NET Framework 4, only fully trusted code can set maxStackSize to a value that is greater than the default stack size (1 megabyte). Pokud je zadaná větší hodnota pro maxStackSize, když je kód spuštěný s částečnou důvěryhodností, maxStackSize se ignoruje a použije se výchozí velikost zásobníku.If a larger value is specified for maxStackSize when code is running with partial trust, maxStackSize is ignored and the default stack size is used. Není vyvolána žádná výjimka.No exception is thrown. Kód na libovolné úrovni vztahu důvěryhodnosti může nastavit maxStackSize na hodnotu, která je menší než výchozí velikost zásobníku.Code at any trust level can set maxStackSize to a value that is less than the default stack size.

Poznámka

Pokud vyvíjíte plně důvěryhodnou knihovnu, která bude používána částečně důvěryhodným kódem, a potřebujete spustit vlákno, které vyžaduje velký zásobník, je nutné před vytvořením vlákna uplatnit úplný vztah důvěryhodnosti, nebo bude použita výchozí velikost zásobníku.If you are developing a fully trusted library that will be used by partially trusted code, and you need to start a thread that requires a large stack, you must assert full trust before creating the thread, or the default stack size will be used. Tento postup neprovádějte, pokud plně neovládáte kód, který je spuštěn ve vlákně.Do not do this unless you fully control the code that runs on the thread.

Pokud je maxStackSize menší než minimální velikost zásobníku, použije se minimální velikost zásobníku.If maxStackSize is less than the minimum stack size, the minimum stack size is used. Pokud maxStackSize není násobkem velikosti stránky, zaokrouhlí se na další větší násobek velikosti stránky.If maxStackSize is not a multiple of the page size, it is rounded to the next larger multiple of the page size. Pokud například používáte .NET Framework verze 2,0 v systému Windows Vista, je minimální velikost zásobníku 256KB (262 144 bajtů) a velikost stránky je 64 kB (65 536 bajtů).For example, if you are using the .NET Framework version 2.0 on Windows Vista, 256KB (262,144 bytes) is the minimum stack size, and the page size is 64KB (65,536 bytes).

Poznámka

Ve verzích systému Microsoft Windows starších než Windows XP a Windows Server 2003 se maxStackSize ignoruje a je použita velikost zásobníku zadaná v záhlaví spustitelného souboru.On versions of Microsoft Windows prior to Windows XP and Windows Server 2003, maxStackSize is ignored, and the stack size specified in the executable header is used.

Pokud zadáte velmi malou velikost zásobníku, možná budete muset zakázat zjišťování přetečení zásobníku.If you specify a very small stack size, you might need to disable stack-overflow probing. Pokud je zásobník vážně omezený, může zjišťování způsobit přetečení zásobníku.When the stack is severely constrained, the probing can itself cause a stack overflow. Chcete-li zakázat zjišťování přetečení zásobníku, přidejte následující do konfiguračního souboru aplikace.To disable stack overflow probing, add the following to your application configuration file.

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

Platí pro