SemaphoreFullException Класс

Определение

public ref class SemaphoreFullException : Exception

public ref class SemaphoreFullException : SystemException

public class SemaphoreFullException : Exception

public class SemaphoreFullException : SystemException

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

type SemaphoreFullException = class
    inherit Exception

type SemaphoreFullException = class
    inherit SystemException

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

Public Class SemaphoreFullException
Inherits Exception

Public Class SemaphoreFullException
Inherits SystemException

Наследование

Object

Exception

SemaphoreFullException

Наследование

Object

Exception

SystemException

SemaphoreFullException

Атрибуты

ComVisibleAttribute SerializableAttribute

Примеры

В следующем примере кода показано, как ошибка программирования в одном потоке может привести к SemaphoreFullException другому потоку: два потока введите семафор. Второй поток освобождает семафор дважды, в то время как первый поток по-прежнему выполняет свою задачу. После завершения первого потока и выпуска семафора число семафоров уже заполнено, и создается исключение.

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.
'

Комментарии

Количество семафоров уменьшается каждый раз, когда поток входит в семафор и увеличивается при выпуске семафора потока. Если число равно нулю, последующие запросы блокируются до тех пор, пока другие потоки не отпустит семафор. Когда все потоки выпустили семафор, счетчик находится в максимальном значении, указанном при создании семафора. Если ошибка программирования вызывает метод Semaphore.Release в данный момент, SemaphoreFullException создается исключение.

SemaphoreFullException не обязательно указывает на проблему с кодом, в котором произошло исключение. Рассмотрим следующий сценарий: Поток A и поток B введите семафор, который имеет максимальное количество двух. Ошибка программирования в потоке B вызывает его Release дважды, чтобы число семафоров было заполнено. В результате, когда поток A в конечном итоге вызывает Release, SemaphoreFullException создается исключение.

Список начальных значений свойств для экземпляра SemaphoreFullException класса см. в конструкторе SemaphoreFullException() .

См. также раздел

• Semaphore
• Семафор