SemaphoreFullException Classe

Definição

public ref class SemaphoreFullException : Exception

public ref class SemaphoreFullException : SystemException

public class SemaphoreFullException : Exception

[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class SemaphoreFullException : SystemException

public class SemaphoreFullException : SystemException

type SemaphoreFullException = class
    inherit Exception

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type SemaphoreFullException = class
    inherit SystemException

type SemaphoreFullException = class
    inherit SystemException

Public Class SemaphoreFullException
Inherits Exception

Public Class SemaphoreFullException
Inherits SystemException

Herança

Object

Exception

SemaphoreFullException

Herança

Object

Exception

SystemException

SemaphoreFullException

Atributos

ComVisibleAttribute SerializableAttribute

Exemplos

O exemplo de código seguinte mostra como um erro de programação numa thread pode levar a a SemaphoreFullException noutra thread: Duas threads entram num semáforo. O segundo thread liberta o semáforo duas vezes, enquanto o primeiro thread ainda está a executar a sua tarefa. Quando o primeiro fio termina e liberta o semáforo, a contagem de semáforos já está cheia e é lançada uma exceção.

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.
 */

Imports System.Threading

Public Class Example

    ' A semaphore that can satisfy at most two concurrent
    ' requests.
    '
    Private Shared _pool As New Semaphore(2, 2)

    <MTAThread> _
    Public Shared Sub Main()
        ' Create and start two threads, A and B. 
        '
        Dim tA As New Thread(AddressOf ThreadA)
        tA.Start()

        Dim tB As New Thread(AddressOf ThreadB)
        tB.Start()

    End Sub

    Private Shared Sub 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 ex As Exception
            Console.WriteLine("Thread A: {0}", ex.Message)
        End Try
    End Sub

    Private Shared Sub 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.")
    End Sub
End Class
' 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.
'

Observações

A contagem num semáforo é decrementada cada vez que um fio entra no semáforo, e incrementada quando um fio liberta o semáforo. Quando a contagem é zero, os pedidos subsequentes bloqueiam até que outros threads libertem o semáforo. Quando todas as threads libertam o semáforo, a contagem está no valor máximo especificado quando o semáforo foi criado. Se um erro de programação fizer com que um thread chame o Semaphore.Release método neste ponto, um SemaphoreFullException é lançado.

SemaphoreFullException não indica necessariamente um problema com o código onde ocorreu a exceção. Considere o seguinte cenário: O fio A e o fio B entram num semáforo que tem uma contagem máxima de dois. Um erro de programação na thread B faz com que chame Release duas vezes, de modo que a contagem no semáforo fica completa. Como resultado, quando o fio A eventualmente chama Release, a SemaphoreFullException é lançado.

Para uma lista de valores iniciais de propriedades para uma instância da SemaphoreFullException classe, veja o SemaphoreFullException() construtor.

Ver também

• Semaphore
• Semáforo