Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase WaitHandle

 

Publicado: octubre de 2016

Encapsula los objetos específicos del sistema operativo que esperan obtener un acceso exclusivo a los recursos compartidos.

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

System.Object
  System.MarshalByRefObject
    System.Threading.WaitHandle
      System.Threading.EventWaitHandle
      System.Threading.Mutex
      System.Threading.Semaphore

[<AbstractClass>]
[<ComVisibleAttribute(true)>]
type WaitHandle = 
    class
        inherit MarshalByRefObject
        interface IDisposable
    end

NombreDescripción
System_CAPS_protmethodWaitHandle()

Inicializa una nueva instancia de la clase WaitHandle.

NombreDescripción
System_CAPS_pubpropertyHandle

Obsoleto. Obtiene o establece el identificador del sistema operativo nativo.

System_CAPS_pubpropertySafeWaitHandle

Obtiene o establece el identificador del sistema operativo nativo.

NombreDescripción
System_CAPS_pubmethodClose()

Libera todos los recursos mantenidos por el objeto WaitHandle actual.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar a un proxy que se utiliza para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos usados por la instancia actual de la clase WaitHandle.

System_CAPS_protmethodDispose(Boolean)

Cuando se reemplaza en una clase derivada, libera los recursos no administrados que usa WaitHandle y, de forma opcional, libera los recursos administrados.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del elemento actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodSystem_CAPS_staticSignalAndWait(WaitHandle, WaitHandle)

Señala un WaitHandle y espera en otro.

System_CAPS_pubmethodSystem_CAPS_staticSignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)

Señala un WaitHandle y espera en otro, para lo que determina un intervalo de tiempo de espera como entero con signo de 32 bits y especifica si se sale del dominio de sincronización para el contexto antes de entrar en la espera.

System_CAPS_pubmethodSystem_CAPS_staticSignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)

Señala un WaitHandle y espera en otro, para lo que determina el intervalo de tiempo de espera como TimeSpan y especifica si se sale del dominio de sincronización para el contexto antes de entrar en la espera.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticWaitAll(WaitHandle[])

Espera a que todos los elementos de la matriz especificada reciban una señal.

System_CAPS_pubmethodSystem_CAPS_staticWaitAll(WaitHandle[], Int32)

Espera a que todos los elementos de la matriz especificada reciban una señal mediante un valor Int32 para especificar el intervalo de tiempo.

System_CAPS_pubmethodSystem_CAPS_staticWaitAll(WaitHandle[], Int32, Boolean)

Espera a que todos los elementos de la matriz especificada reciban una señal; usa un valor Int32 para determinar el intervalo de tiempo y especifica si se va a salir del dominio de sincronización antes de finalizar la espera.

System_CAPS_pubmethodSystem_CAPS_staticWaitAll(WaitHandle[], TimeSpan)

Espera a que todos los elementos de la matriz especificada reciban una señal, usando un valor TimeSpan para especificar el intervalo de tiempo.

System_CAPS_pubmethodSystem_CAPS_staticWaitAll(WaitHandle[], TimeSpan, Boolean)

Espera a que todos los elementos de la matriz especificada reciban una señal; usa un valor TimeSpan para determinar el intervalo de tiempo y especifica si se va a salir del dominio de sincronización antes de finalizar la espera.

System_CAPS_pubmethodSystem_CAPS_staticWaitAny(WaitHandle[])

Espera a que cualquiera de los elementos de la matriz especificada reciba una señal.

System_CAPS_pubmethodSystem_CAPS_staticWaitAny(WaitHandle[], Int32)

Espera a que cualquiera de los elementos de la matriz especificada reciba una señal, utilizando un entero de 32 bits con signo para especificar el intervalo de tiempo.

System_CAPS_pubmethodSystem_CAPS_staticWaitAny(WaitHandle[], Int32, Boolean)

Espera a que cualquiera de los elementos de la matriz especificada reciba una señal; utiliza un entero de 32 bits con signo para determinar el intervalo de tiempo y especifica si se va a salir del dominio de sincronización antes de la espera.

System_CAPS_pubmethodSystem_CAPS_staticWaitAny(WaitHandle[], TimeSpan)

Espera a que cualquiera de los elementos de la matriz especificada reciba una señal, usando un TimeSpan para especificar el intervalo de tiempo.

System_CAPS_pubmethodSystem_CAPS_staticWaitAny(WaitHandle[], TimeSpan, Boolean)

Espera a que cualquiera de los elementos de la matriz especificada reciba una señal; usa un TimeSpan para especificar el intervalo de tiempo y especifica si se va a salir del dominio de sincronización antes de la espera.

System_CAPS_pubmethodWaitOne()

Bloquea el subproceso actual hasta que el objeto WaitHandle actual recibe una señal.

System_CAPS_pubmethodWaitOne(Int32)

Bloquea el subproceso actual hasta que el objeto WaitHandle actual recibe una señal, usando un entero de 32 bits con signo para especificar el intervalo de tiempo en milisegundos.

System_CAPS_pubmethodWaitOne(Int32, Boolean)

Bloquea el subproceso actual hasta que el objeto WaitHandle actual recibe una señal, usa un entero de 32 bits con signo para determinar el intervalo de tiempo y especifica si hay que salir del dominio de sincronización antes de la espera.

System_CAPS_pubmethodWaitOne(TimeSpan)

Bloquea el subproceso actual hasta que la instancia actual recibe una señal, usando TimeSpan para especificar el intervalo de tiempo.

System_CAPS_pubmethodWaitOne(TimeSpan, Boolean)

Bloquea el subproceso actual hasta que la instancia actual recibe una señal; usa TimeSpan para determinar el intervalo de tiempo y especifica si hay que abandonar el dominio de sincronización antes de la espera.

NombreDescripción
System_CAPS_protfieldSystem_CAPS_staticInvalidHandle

Representa un identificador del sistema operativo nativo no válido. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticWaitTimeout

Indica que una operación WaitAny ha superado el tiempo de espera antes de que se señalara un identificador de espera. Este campo es constante.

NombreDescripción
System_CAPS_pubmethodGetSafeWaitHandle()

Obtiene el identificador seguro para un identificador de espera del sistema operativo nativo.(Definido por WaitHandleExtensions).

System_CAPS_pubmethodSetSafeWaitHandle(SafeWaitHandle)

Establece un controlador seguro para un identificador de espera del sistema operativo nativo.(Definido por WaitHandleExtensions).

The T:System.Threading.WaitHandle class encapsulates Win32 synchronization handles, and is used to represent all synchronization objects in the runtime that allow multiple wait operations. For a comparison of wait handles with other synchronization objects, see Overview of Synchronization Primitives.

The T:System.Threading.WaitHandle class itself is abstract. Classes derived from T:System.Threading.WaitHandle define a signaling mechanism to indicate taking or releasing access to a shared resource, but they use the inherited T:System.Threading.WaitHandle methods to block while waiting for access to shared resources. The classes derived from T:System.Threading.WaitHandle include:

  • The T:System.Threading.Mutex class. See Mutexes.

  • The T:System.Threading.EventWaitHandle class and its derived classes, T:System.Threading.AutoResetEvent and T:System.Threading.ManualResetEvent. See EventWaitHandle, AutoResetEvent, and ManualResetEvent.

  • The T:System.Threading.Semaphore class. See Semaphores.

Threads can block on an individual wait handle by calling the instance method M:System.Threading.WaitHandle.WaitOne, which is inherited by classes derived from T:System.Threading.WaitHandle.

The derived classes of T:System.Threading.WaitHandle differ in their thread affinity. Event wait handles (T:System.Threading.EventWaitHandle, T:System.Threading.AutoResetEvent, and T:System.Threading.ManualResetEvent) and semaphores do not have thread affinity; any thread can signal an event wait handle or semaphore. Mutexes, on the other hand, do have thread affinity; the thread that owns a mutex must release it, and an exception is thrown if a thread calls the M:System.Threading.Mutex.ReleaseMutex method on a mutex that it does not own.

Because the T:System.Threading.WaitHandle class derives from T:System.MarshalByRefObject, these classes can be used to synchronize the activities of threads across application domain boundaries.

In addition to its derived classes, the T:System.Threading.WaitHandle class has a number of static methods that block a thread until one or more synchronization objects receive a signal.. These include:

  • SignalAndWait, which allows a thread to signal one wait handle and immediately wait on another.

  • WaitAll, which allows a thread to wait until all the wait handles in an array receive a signal.

  • WaitAny, which allows a thread to wait until any one of a specified set of wait handles has been signaled .

The overloads of these methods provide timeout intervals for abandoning the wait, and the opportunity to exit a synchronization context before entering the wait, allowing other threads to use the synchronization context.

System_CAPS_importantImportante

This type implements the T:System.IDisposable interface. When you have finished using the type or a type derived from it, you should dispose of it either directly or indirectly. To dispose of the type directly, call its M:System.Threading.WaitHandle.Close method in a try/catch block. To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). For more information, see the “Using an Object that Implements IDisposable” section in the T:System.IDisposable interface topic.

WaitHandle implements the Dispose pattern. See Patrón de Dispose. When you derive from WaitHandle, use the SafeWaitHandle property to store your native handle operating system handle. You do not need to override the protected Dispose method unless you use additional unmanaged resources.

The following code example shows how two threads can do background tasks while the Main thread waits for the tasks to complete using the static M:System.Threading.WaitHandle.WaitAny(System.Threading.WaitHandle[]) and M:System.Threading.WaitHandle.WaitAll(System.Threading.WaitHandle[]) methods of the T:System.Threading.WaitHandle class.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

This type is thread safe.

Volver al principio
Mostrar: