Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

ThreadPool.QueueUserWorkItem (Método) (WaitCallback, Object)

Pone un método en cola para su ejecución y especifica un objeto que contiene los datos que debe utilizar el método. El método se ejecuta cuando hay un subproceso de grupo de subprocesos disponible.

Espacio de nombres:  System.Threading
Ensamblado:  mscorlib (en mscorlib.dll)

public static bool QueueUserWorkItem(
	WaitCallback callBack,
	Object state
)

Parámetros

callBack
Tipo: System.Threading.WaitCallback
WaitCallback que representa el método que se va a ejecutar.
state
Tipo: System.Object
Objeto que contiene los datos que va a utilizar el método.

Valor devuelto

Tipo: System.Boolean
true si el método se pone en la cola correctamente; se produce la excepción NotSupportedException si no se puede poner en la cola el elemento de trabajo.

ExcepciónCondición
NotSupportedException

Common Language Runtime (CLR) está en un host y el host no admite esta acción.

ArgumentNullException

El valor de callBack es null.

Si el método de devolución de llamada requiere datos complejos, se puede definir una clase que los contenga.

NotaNota

Los usuarios de Visual Basic pueden omitir el constructor WaitCallback y utilizar simplemente el operador AddressOf al pasar el método de devolución de llamadas a QueueUserWorkItem. Visual Basic llama automáticamente al constructor del delegado correcto.

Información de versiones

En la versión 2.0 de .NET Framework, el valor de la propiedad Thread.CurrentPrincipal se difunde a los subprocesos de trabajo almacenados en la cola utilizando el método QueueUserWorkItem. En las versiones anteriores, la información principal no se difunde.

En el ejemplo siguiente se muestra cómo crear un objeto que contiene información de tarea. También se muestra cómo pasar ese objeto a una tarea que se pone en la cola para que la ejecute el grupo de subprocesos.


// This example shows how to create an object containing task
// information, and pass that object to a task queued for
// execution by the thread pool.
using System;
using System.Threading;

// TaskInfo holds state information for a task that will be
// executed by a ThreadPool thread.
public class TaskInfo 
    {
    // State information for the task.  These members
    // can be implemented as read-only properties, read/write
    // properties with validation, and so on, as required.
    public string Boilerplate;
    public int Value;

    // Public constructor provides an easy way to supply all
    // the information needed for the task.
    public TaskInfo(string text, int number) {
        Boilerplate = text;
        Value = number;
    }
}

public class Example {
    public static void Main()
    {
        // Create an object containing the information needed
        // for the task.
        TaskInfo ti = new TaskInfo("This report displays the number {0}.", 42);

        // Queue the task and data.
        ThreadPool.QueueUserWorkItem(new WaitCallback(ThreadProc), ti);

        Console.WriteLine("Main thread does some work, then sleeps.");

        // If you comment out the Sleep, the main thread exits before
        // the ThreadPool task has a chance to run.  ThreadPool uses 
        // background threads, which do not keep the application 
        // running.  (This is a simple example of a race condition.)
        Thread.Sleep(1000);

        Console.WriteLine("Main thread exits.");
    }

    // The thread procedure performs the independent task, in this case
    // formatting and printing a very simple report.
    //
    static void ThreadProc(Object stateInfo) 
    {
        TaskInfo ti = (TaskInfo) stateInfo;
        Console.WriteLine(ti.Boilerplate, ti.Value); 
    }
}


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: