Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
ThreadPool (Clase)
Proporciona un grupo de subprocesos que pueden utilizarse para ejecutar tareas, exponer elementos de trabajo, procesar la E/S asincrónica, esperar en nombre de otros subprocesos y procesar temporizadores.
Ensamblado: mscorlib (en mscorlib.dll)
El tipo ThreadPool expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
|
BindHandle(IntPtr) | Obsoleto. Enlaza un identificador del sistema operativo a ThreadPool. |
|
|
BindHandle(SafeHandle) | Enlaza un identificador del sistema operativo a ThreadPool. |
|
|
GetAvailableThreads | Recupera la diferencia entre el número máximo de subprocesos de grupo de subprocesos devuelto por el método GetMaxThreads y el número activo actualmente. |
|
GetMaxThreads | Recupera el número de solicitudes al grupo de subprocesos que pueden estar activas al mismo tiempo. Todas las solicitudes que pasen de ese número permanecen en la cola hasta que haya subprocesos de grupo de subprocesos disponibles. |
|
|
GetMinThreads | Recupera el número mínimo de subprocesos que el grupo de subprocesos crea a petición, según se realizan nuevas solicitudes, antes de la conmutación a un algoritmo para administrar la creación y destrucción de subprocesos. |
|
|
QueueUserWorkItem(WaitCallback) | Pone en cola un método para su ejecución. El método se ejecuta cuando hay un subproceso de grupo de subprocesos disponible. |
|
|
QueueUserWorkItem(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. |
|
|
RegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un entero de 32 bits con signo para representar el tiempo de espera en milisegundos. |
|
|
RegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int64, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un entero de 64 bits con signo para representar el tiempo de espera en milisegundos. |
|
|
RegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, TimeSpan, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un valor de TimeSpan para el tiempo de espera. |
|
|
RegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, UInt32, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un entero de 32 bits sin signo para representar el tiempo de espera en milisegundos. |
|
|
SetMaxThreads | Establece el número de solicitudes al grupo de subprocesos que pueden estar activas al mismo tiempo. Todas las solicitudes que pasen de ese número permanecen en la cola hasta que haya subprocesos de grupo de subprocesos disponibles. |
|
|
SetMinThreads | Establece el número mínimo de subprocesos que el grupo de subprocesos crea a petición, según se realizan nuevas solicitudes, antes de la conmutación a un algoritmo para administrar la creación y destrucción de subprocesos. |
|
|
UnsafeQueueNativeOverlapped | Pone en cola una operación de E/S superpuesta para que se ejecute. |
|
|
UnsafeQueueUserWorkItem | Pone en cola el delegado especificado en el grupo de subprocesos, pero no propaga la pila de llamadas al subproceso de trabajo. |
|
|
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int32, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, utilizando un entero de 32 bits con signo para representar el tiempo de espera en milisegundos. Este método no propaga la pila de llamadas al subproceso de trabajo. |
|
|
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, Int64, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un entero de 64 bits con signo para representar el tiempo de espera en milisegundos. Este método no propaga la pila de llamadas al subproceso de trabajo. |
|
|
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, TimeSpan, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un valor de TimeSpan para el tiempo de espera. Este método no propaga la pila de llamadas al subproceso de trabajo. |
|
|
UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, Object, UInt32, Boolean) | Registra un delegado que va a esperar a una clase WaitHandle, especificando un entero de 32 bits sin signo para representar el tiempo de espera en milisegundos. Este método no propaga la pila de llamadas al subproceso de trabajo. |
Muchas aplicaciones crean subprocesos que pasan mucho tiempo en estado de inactividad, esperando a que se produzca un evento. Otros subprocesos pueden entrar en estado de inactividad y activarse periódicamente para comprobar si se ha producido algún cambio o para actualizar la información de estado. El grupo de subprocesos permite utilizar los subprocesos de forma más eficaz, ya que suministra a la aplicación un grupo de subprocesos de trabajo administrados por el sistema. Los ejemplos de operaciones que usan subprocesos de grupo de subprocesos incluyen los siguientes:
-
Al crear un objeto Task<TResult> o Task para realizar alguna tarea de forma asincrónica, de forma predeterminada la tarea se programa para ejecutarse en un subproceso del grupo de subprocesos.
-
Los temporizadores asincrónicos utilizan el grupo de subprocesos. Los subprocesos del grupo de subprocesos ejecutan devoluciones de llamada desde la clase System.Threading.Timer y generan eventos desde la clase System.Timers.Timer.
-
Al utilizar controladores de espera registrados, un subproceso del sistema supervisa el estado de los controladores de espera. Cuando una operación de espera finaliza, un subproceso de trabajo del grupo de subprocesos ejecuta la función de devolución de llamada correspondiente.
Nota
|
|---|
|
Los subprocesos del grupo de subprocesos administrados son los subprocesos de fondo. Es decir, sus propiedades IsBackground son true. Esto significa que un subproceso ThreadPool no hará que la aplicación se siga ejecutando cuando todos los subprocesos de primer plano hayan terminado. |
También pueden colocarse en la cola del grupo de subprocesos elementos de trabajo no relacionados con una operación de espera. Para solicitar que un subproceso del grupo de subprocesos controle un elemento de trabajo, hay que llamar al método QueueUserWorkItem. Este método toma como parámetro una referencia al método o delegado al que llamará el subproceso seleccionado del grupo de subprocesos. No se puede cancelar un elemento de trabajo después de haberlo colocado en la cola.
Los temporizadores de la cola de temporizadores y las operaciones de espera registradas también utilizan el grupo de subprocesos. Sus funciones de devolución de llamada se colocan en la cola del grupo de subprocesos.
Hay un grupo de subprocesos por proceso. A partir de .NET Framework versión 4, el tamaño predeterminado del grupo de subprocesos de un proceso depende de varios factores, como el tamaño del espacio de direcciones virtuales. Un proceso puede llamar al método GetMaxThreads para determinar el número de subprocesos. El número de subprocesos del grupo de subprocesos se puede cambiar mediante el método SetMaxThreads. Cada subproceso utiliza el tamaño de pila predeterminado y se ejecuta con la prioridad predeterminada.
|
Nota
|
|---|
|
El código no administrado que hospeda .NET Framework puede cambiar el tamaño del grupo de subprocesos mediante la función CorSetMaxThreads definida en el archivo mscoree.h. |
El grupo de subprocesos proporciona nuevos subprocesos de trabajo o subprocesos de finalización de E/S a petición hasta que alcanza el mínimo para cada categoría. Cuando se alcanza un valor mínimo, el grupo de subprocesos puede crear subprocesos adicionales en esa categoría o esperar hasta que se completen algunas tareas. A partir de .NET Framework 4, el grupo de subprocesos crea y destruye los subprocesos de trabajo para optimizar el rendimiento, que se define como el número de tareas completadas por unidad de tiempo. Es posible que si hay muy pocos subprocesos, no se haga un uso óptimo de los recursos disponibles, mientras que demasiados subprocesos podrían aumentar la contención de recursos.
|
Nota
|
|---|
|
Cuando la petición es baja, el número real de subprocesos del grupo de subprocesos puede situarse por debajo de los valores mínimos. |
Puede usar el método GetMinThreads para obtener estos valores mínimos.
Precaución
|
|---|
|
Puede usar el método SetMinThreads para aumentar el número mínimo de subprocesos. Sin embargo, aumentar estos valores innecesariamente puede producir problemas de rendimiento. Si se inician demasiadas tareas al mismo tiempo, puede parecer que todas se realizan con lentitud. En la mayoría de los casos, el grupo de subprocesos se comportará mejor con su propio algoritmo para asignar los subprocesos. |
Cuando el grupo de subprocesos reutiliza un subproceso, no borra los datos del almacenamiento local de subprocesos ni de los campos marcados con el atributo ThreadStaticAttribute. Por consiguiente, los datos que un método guarda en el almacenamiento local de subprocesos pueden ser expuestos por cualquier otro método que se ejecute en el mismo subproceso del grupo de subprocesos. Un método que tiene acceso a un campo que se marca con el atributo ThreadStaticAttribute podría encontrar datos diferentes dependiendo de qué subproceso del grupo de subprocesos lo ejecute.
|
Nota
|
|---|
|
El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de la propiedad Resources: Synchronization | ExternalThreading. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host. |
using System; using System.Threading; public class Example { public static void Main() { // Queue the task. ThreadPool.QueueUserWorkItem(new WaitCallback(ThreadProc)); Console.WriteLine("Main thread does some work, then sleeps."); // If you comment out the Sleep, the main thread exits before // the thread pool task runs. The thread pool 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."); } // This thread procedure performs the task. static void ThreadProc(Object stateInfo) { // No state object was passed to QueueUserWorkItem, so // stateInfo is null. Console.WriteLine("Hello from the thread pool."); } }
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.
