Thread Constructores

Definición

Inicializa una nueva instancia de la clase Thread.Initializes a new instance of the Thread class.

Sobrecargas

Thread(ParameterizedThreadStart)

Inicializa una nueva instancia de la clase Thread, especificando un delegado que permite pasar un objeto al subproceso cuando este último se inicia.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)

Inicializa una nueva instancia de la clase Thread.Initializes a new instance of the Thread class.

Thread(ParameterizedThreadStart, Int32)

Inicializa una nueva instancia de la clase Thread y, para ello, especifica un delegado que permite pasar un objeto al subproceso cuando este último se inicia; además, especifica el tamaño de pila máximo para el subproceso.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)

Inicializa una nueva instancia de la clase Thread, especificando el tamaño de pila máximo para el subproceso.Initializes a new instance of the Thread class, specifying the maximum stack size for the thread.

Thread(ParameterizedThreadStart)

Inicializa una nueva instancia de la clase Thread, especificando un delegado que permite pasar un objeto al subproceso cuando este último se inicia.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)

Parámetros

start
ParameterizedThreadStart

Delegado que representa los métodos que deben invocarse cuando empieza a ejecutarse este subproceso.A delegate that represents the methods to be invoked when this thread begins executing.

Excepciones

start es null.start is null.

Ejemplos

En el ejemplo siguiente se muestra la sintaxis para crear y usar un delegado ParameterizedThreadStart con un método estático y un método de instancia.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.'

Comentarios

Un subproceso no comienza A ejecutarse cuando se crea.A thread does not begin executing when it is created. Para programar el subproceso para su ejecución, llame al método Start.To schedule the thread for execution, call the Start method. Para pasar un objeto de datos al subproceso, use la sobrecarga del método Start(Object).To pass a data object to the thread, use the Start(Object) method overload.

Nota

Visual Basic los usuarios pueden omitir el constructor ThreadStart al crear un subproceso.Visual Basic users can omit the ThreadStart constructor when creating a thread. Use el operador AddressOf al pasar el método, por ejemplo 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 llama automáticamente al constructor ThreadStart.Visual Basic automatically calls the ThreadStart constructor.

Consulte también:

Thread(ThreadStart)

Inicializa una nueva instancia de la clase 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)

Parámetros

start
ThreadStart

Delegado ThreadStart que representa los métodos que deben invocarse cuando empieza a ejecutarse este subproceso.A ThreadStart delegate that represents the methods to be invoked when this thread begins executing.

Excepciones

El parámetro start es null.The start parameter is null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un subproceso que ejecuta un método estático.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

En el ejemplo de código siguiente se muestra cómo crear un subproceso que ejecuta un método de instancia.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

Comentarios

Un subproceso no comienza A ejecutarse cuando se crea.A thread does not begin executing when it is created. Para programar el subproceso para su ejecución, llame al método Start.To schedule the thread for execution, call the Start method.

Nota

Visual Basic los usuarios pueden omitir el constructor ThreadStart al crear un subproceso.Visual Basic users can omit the ThreadStart constructor when creating a thread. Use el operador AddressOf al pasar el método, por ejemplo 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 llama automáticamente al constructor ThreadStart.Visual Basic automatically calls the ThreadStart constructor.

Consulte también:

Thread(ParameterizedThreadStart, Int32)

Inicializa una nueva instancia de la clase Thread y, para ello, especifica un delegado que permite pasar un objeto al subproceso cuando este último se inicia; además, especifica el tamaño de pila máximo para el subproceso.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)

Parámetros

start
ParameterizedThreadStart

Delegado ParameterizedThreadStart que representa los métodos que deben invocarse cuando empieza a ejecutarse este subproceso.A ParameterizedThreadStart delegate that represents the methods to be invoked when this thread begins executing.

maxStackSize
Int32

Tamaño de pila máximo, en bytes, que va a usar el subproceso, o 0 para usar el tamaño de pila máximo predeterminado especificado en el encabezado del ejecutable.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.

Importante   En el caso de código de confianza parcial, se pasa por alto maxStackSize si es mayor que el tamaño de pila predeterminado.Important For partially trusted code, maxStackSize is ignored if it is greater than the default stack size. No se inicia ninguna excepción.No exception is thrown.

Excepciones

start es null.start is null.

maxStackSize es menor que cero.maxStackSize is less than zero.

Comentarios

Evite el uso de esta sobrecarga del constructor.Avoid using this constructor overload. El tamaño de pila predeterminado utilizado por la sobrecarga del constructor Thread(ParameterizedThreadStart) es el tamaño de pila recomendado para los subprocesos.The default stack size used by the Thread(ParameterizedThreadStart) constructor overload is the recommended stack size for threads. Si un subproceso tiene problemas de memoria, la causa más probable es un error de programación, como una recursividad infinita.If a thread has memory problems, the most likely cause is programming error, such as infinite recursion.

Importante

A partir de .NET Framework 4.NET Framework 4, solo el código de plena confianza puede establecer maxStackSize en un valor que sea mayor que el tamaño de pila predeterminado (1 megabyte).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). Si se especifica un valor mayor para maxStackSize cuando el código se ejecuta con confianza parcial, maxStackSize se omite y se utiliza el tamaño de pila predeterminado.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. No se inicia ninguna excepción.No exception is thrown. El código en cualquier nivel de confianza puede establecer maxStackSize en un valor que sea menor que el tamaño de pila predeterminado.Code at any trust level can set maxStackSize to a value that is less than the default stack size.

Nota

Si está desarrollando una biblioteca de plena confianza que se usará en el código de confianza parcial y necesita iniciar un subproceso que requiera una pila grande, debe validar la plena confianza antes de crear el subproceso o se usará el tamaño de pila predeterminado.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. No lo haga a menos que controle por completo el código que se ejecuta en el subproceso.Do not do this unless you fully control the code that runs on the thread.

Si maxStackSize es menor que el tamaño de pila mínimo, se usa el tamaño de pila mínimo.If maxStackSize is less than the minimum stack size, the minimum stack size is used. Si maxStackSize no es múltiplo del tamaño de página, se redondea al siguiente múltiplo mayor del tamaño de página.If maxStackSize is not a multiple of the page size, it is rounded to the next larger multiple of the page size. Por ejemplo, si usa la versión .NET Framework 2,0 en Windows Vista, 256 KB (262.144 bytes) es el tamaño de pila mínimo y el tamaño de página es de 64 KB (65.536 bytes).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).

Nota

En las versiones de Microsoft Windows anteriores a Windows XP y Windows Server 2003, se omite maxStackSize y se utiliza el tamaño de pila especificado en el encabezado ejecutable.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.

Si especifica un tamaño de pila muy pequeño, puede que tenga que deshabilitar el sondeo de desbordamiento de pila.If you specify a very small stack size, you might need to disable stack-overflow probing. Cuando la pila está muy restringida, el sondeo puede provocar un desbordamiento de pila.When the stack is severely constrained, the probing can itself cause a stack overflow. Para deshabilitar el sondeo de desbordamiento de pila, agregue lo siguiente al archivo de configuración de la aplicación.To disable stack overflow probing, add the following to your application configuration file.

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

Thread(ThreadStart, Int32)

Inicializa una nueva instancia de la clase Thread, especificando el tamaño de pila máximo para el subproceso.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)

Parámetros

start
ThreadStart

Delegado ThreadStart que representa los métodos que deben invocarse cuando empieza a ejecutarse este subproceso.A ThreadStart delegate that represents the methods to be invoked when this thread begins executing.

maxStackSize
Int32

Tamaño de pila máximo, en bytes, que va a usar el subproceso, o 0 para usar el tamaño de pila máximo predeterminado especificado en el encabezado del ejecutable.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.

Importante   En el caso de código de confianza parcial, se pasa por alto maxStackSize si es mayor que el tamaño de pila predeterminado.Important For partially trusted code, maxStackSize is ignored if it is greater than the default stack size. No se inicia ninguna excepción.No exception is thrown.

Excepciones

start es null.start is null.

maxStackSize es menor que cero.maxStackSize is less than zero.

Comentarios

Evite el uso de esta sobrecarga del constructor.Avoid using this constructor overload. El tamaño de pila predeterminado utilizado por la sobrecarga del constructor Thread(ThreadStart) es el tamaño de pila recomendado para los subprocesos.The default stack size used by the Thread(ThreadStart) constructor overload is the recommended stack size for threads. Si un subproceso tiene problemas de memoria, la causa más probable es un error de programación, como una recursividad infinita.If a thread has memory problems, the most likely cause is programming error, such as infinite recursion.

Importante

A partir de .NET Framework 4.NET Framework 4, solo el código de plena confianza puede establecer maxStackSize en un valor que sea mayor que el tamaño de pila predeterminado (1 megabyte).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). Si se especifica un valor mayor para maxStackSize cuando el código se ejecuta con confianza parcial, maxStackSize se omite y se utiliza el tamaño de pila predeterminado.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. No se inicia ninguna excepción.No exception is thrown. El código en cualquier nivel de confianza puede establecer maxStackSize en un valor que sea menor que el tamaño de pila predeterminado.Code at any trust level can set maxStackSize to a value that is less than the default stack size.

Nota

Si está desarrollando una biblioteca de plena confianza que se usará en el código de confianza parcial y necesita iniciar un subproceso que requiera una pila grande, debe validar la plena confianza antes de crear el subproceso o se usará el tamaño de pila predeterminado.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. No lo haga a menos que controle por completo el código que se ejecuta en el subproceso.Do not do this unless you fully control the code that runs on the thread.

Si maxStackSize es menor que el tamaño de pila mínimo, se usa el tamaño de pila mínimo.If maxStackSize is less than the minimum stack size, the minimum stack size is used. Si maxStackSize no es múltiplo del tamaño de página, se redondea al siguiente múltiplo mayor del tamaño de página.If maxStackSize is not a multiple of the page size, it is rounded to the next larger multiple of the page size. Por ejemplo, si usa la versión .NET Framework 2,0 en Windows Vista, 256 KB (262.144 bytes) es el tamaño de pila mínimo y el tamaño de página es de 64 KB (65.536 bytes).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).

Nota

En las versiones de Microsoft Windows anteriores a Windows XP y Windows Server 2003, se omite maxStackSize y se utiliza el tamaño de pila especificado en el encabezado ejecutable.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.

Si especifica un tamaño de pila muy pequeño, puede que tenga que deshabilitar el sondeo de desbordamiento de pila.If you specify a very small stack size, you might need to disable stack-overflow probing. Cuando la pila está muy restringida, el sondeo puede provocar un desbordamiento de pila.When the stack is severely constrained, the probing can itself cause a stack overflow. Para deshabilitar el sondeo de desbordamiento de pila, agregue lo siguiente al archivo de configuración de la aplicación.To disable stack overflow probing, add the following to your application configuration file.

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

Se aplica a