SemaphoreFullException クラス

定義

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

継承

Object

Exception

SemaphoreFullException

継承

Object

Exception

SystemException

SemaphoreFullException

属性

ComVisibleAttribute SerializableAttribute

例

次のコード例は、あるスレッドのプログラミング エラーが別のスレッドで SemaphoreFullException につながる可能性がある方法を示しています。2 つのスレッドがセマフォに入ります。 2 番目のスレッドはセマフォを 2 回解放しますが、最初のスレッドはタスクを実行しています。 最初のスレッドが終了してセマフォを解放すると、セマフォの数は既に満杯になり、例外がスローされます。

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

注釈

セマフォのカウントは、スレッドがセマフォに入るたびにデクリメントされ、スレッドがセマフォを解放するとインクリメントされます。 カウントが 0 の場合、後続の要求は、他のスレッドがセマフォを解放するまでブロックします。 すべてのスレッドがセマフォを解放すると、セマフォの作成時に指定された最大値がカウントされます。 プログラミング エラーにより、スレッドがこの時点で Semaphore.Release メソッドを呼び出すと、 SemaphoreFullException がスローされます。

SemaphoreFullException は、例外が発生したコードに問題があることを必ずしも示すわけではありません。 次のシナリオを考えてみましょう。スレッド A とスレッド B は、最大カウントが 2 のセマフォに入ります。 スレッド B でプログラミング エラーが発生すると、 Release が 2 回呼び出され、セマフォのカウントがいっぱいになります。 その結果、スレッド A が最終的に Releaseを呼び出すと、 SemaphoreFullException がスローされます。

SemaphoreFullException クラスのインスタンスの初期プロパティ値の一覧については、SemaphoreFullException() コンストラクターを参照してください。

こちらもご覧ください

• Semaphore
• セマフォ