Exportar (0) Imprimir
Expandir todo

SemaphoreFullException (Clase)

Actualización: noviembre 2007

Excepción que se produce cuando se llama al método Semaphore.Release en un semáforo cuyo recuento ya ha alcanzado el valor máximo.

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

[SerializableAttribute]
[ComVisibleAttribute(false)]
public class SemaphoreFullException : SystemException
/** @attribute SerializableAttribute */ 
/** @attribute ComVisibleAttribute(false) */
public class SemaphoreFullException extends SystemException
public class SemaphoreFullException extends SystemException

El recuento de un semáforo disminuye cada vez que un subproceso entra en el semáforo y aumenta cuando un subproceso libera el semáforo. Cuando el recuento es cero, las solicitudes posteriores se bloquean hasta que otros subprocesos liberan el semáforo. Cuando todos los subprocesos han liberado el semáforo, el recuento alcanza el valor máximo que se especificó al crear el semáforo. Si un error de programación hace que un subproceso llame al método Semaphore.Release en ese momento, se produce una excepción SemaphoreFullException.

3y0a9xke.alert_note(es-es,VS.90).gifNota:

La clase Semaphore no exige la identidad del subproceso en las llamadas a los métodos WaitHandle.WaitOne y Semaphore.Release. No es necesario que el mismo subproceso que llamó a WaitOne llame a Release.

SemaphoreFullException no indica necesariamente que exista un problema con el código donde se produjo la excepción. Consideremos que se encuentra ante el siguiente escenario: los subprocesos A y B entran en un semáforo que tiene un recuento máximo de dos. Un error de programación en el subproceso B hace éste que llame a Release dos veces, para que el recuento en el semáforo sea completo. Como consecuencia, posteriormente, cuando el subproceso A llame a Release, se producirá una excepción SemaphoreFullException.

Para obtener una lista de los valores de propiedad iniciales de una instancia de la clase SemaphoreFullException, vea el constructor SemaphoreFullException().

En el siguiente ejemplo de código se muestra la forma en que un error de programación en un subproceso puede dar lugar a una excepción SemaphoreFullException en otro subproceso: dos subprocesos entran en un semáforo. El segundo subproceso libera el semáforo dos veces, mientras el primer subproceso continúa ejecutando su tarea. Cuando el primer subproceso finaliza y libera el semáforo, el recuento del semáforo ya está completo y se produce una excepción.

using System;
using System.Threading;

public class Example
{
    // A semaphore that can satisfy at most two concurrent
    // requests.
    //
    private static Semaphore _pool = new Semaphore(2, 2);

    public static void Main()
    {
        // Create and start two threads, A and B. 
        //
        Thread tA = new Thread(new ThreadStart(ThreadA));
        tA.Start();

        Thread tB = new Thread(new ThreadStart(ThreadB));
        tB.Start();
    }

    private static void ThreadA()
    {
        // Thread A enters the semaphore and simulates a task
        // that lasts a second.
        //
        _pool.WaitOne();
        Console.WriteLine("Thread A entered the semaphore.");

        Thread.Sleep(1000);

        try
        {
            _pool.Release();
            Console.WriteLine("Thread A released the semaphore.");
        }
        catch(Exception ex)
        {
            Console.WriteLine("Thread A: {0}", ex.Message);
        }
    }

    private static void ThreadB()
    {
        // Thread B simulates a task that lasts half a second,
        // then enters the semaphore.
        //
        Thread.Sleep(500);

        _pool.WaitOne();
        Console.WriteLine("Thread B entered the semaphore.");

        // Due to a programming error, Thread B releases the
        // semaphore twice. To fix the program, delete one line.
        _pool.Release();
        _pool.Release();
        Console.WriteLine("Thread B exits successfully.");
    }
}
/* This code example produces the following output:

Thread A entered the semaphore.
Thread B entered the semaphore.
Thread B exits successfully.
Thread A: Adding the given count to the semaphore would cause it to exceed its maximum count.
 */


import System.*;
import System.Threading.*;

public class Example
{
    // A semaphore that can satisfy at most two concurrent
    // requests.
    //
    private static Semaphore pool = new Semaphore(2, 2);

    public static void main(String[] args)
    {
        // Create and start two threads, A and B. 
        //
        System.Threading.Thread tA = new System.Threading.Thread(new 
            ThreadStart(ThreadA));
        tA.Start();

        System.Threading.Thread tB = new System.Threading.Thread(new 
            ThreadStart(ThreadB));
        tB.Start();
    } //main

    private static void ThreadA()
    {
        // Thread A enters the semaphore and simulates a task
        // that lasts a second.
        //
        pool.WaitOne();
        Console.WriteLine("Thread A entered the semaphore.");
        System.Threading.Thread.Sleep(1000);

        try {
            pool.Release();
            Console.WriteLine("Thread A released the semaphore.");
        }
        catch (System.Exception ex) {
            Console.WriteLine("Thread A: {0}", ex.get_Message());
        }
    } //ThreadA

    private static void ThreadB()
    {
        // Thread B simulates a task that lasts half a second,
        // then enters the semaphore.
        //
        System.Threading.Thread.Sleep(500);
        pool.WaitOne();
        Console.WriteLine("Thread B entered the semaphore.");
        // Due to a programming error, Thread B releases the
        // semaphore twice. To fix the program, delete one line.
        pool.Release();
        pool.Release();
        Console.WriteLine("Thread B exits successfully.");
    } //ThreadB
} //Example
/* This code example produces the following output:

Thread A entered the semaphore.
Thread B entered the semaphore.
Thread B exits successfully.
Thread A: Adding the given count to the semaphore would cause it to 
exceed its maximum count.
 */


System.Object
  System.Exception
    System.SystemException
      System.Threading.SemaphoreFullException

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft