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 두 스레드가 세마포를 입력 합니다.The following code example shows how a programming error in one thread can lead to a SemaphoreFullException in another thread: Two threads enter a semaphore. 두 번째 스레드는 세마포를 두 번 해제 하지만 첫 번째 스레드에서는 해당 작업을 계속 실행 합니다.The second thread releases the semaphore twice, while the first thread is still executing its task. 첫 번째 스레드가 완료 되 고 세마포를 해제 하면 세마포 수가 이미 꽉 차서 예외가 throw 됩니다.When the first thread finishes and releases the semaphore, the semaphore count is already full and an exception is thrown.

#using <System.dll>
using namespace System;
using namespace System::Threading;

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

public:
   static void main()
   {
      // Create and start two threads, A and B.
      //
      Thread^ tA = gcnew Thread( gcnew ThreadStart( ThreadA ) );
      tA->Start();

      Thread^ tB = gcnew Thread( gcnew 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( L"Thread A entered the semaphore." );

      Thread::Sleep( 1000 );

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

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

      _pool->WaitOne();
      Console::WriteLine( L"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( L"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.
 */

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

설명

세마포에 대 한 카운트는 스레드가 세마포에 진입할 때마다 감소 하며, 스레드가 세마포를 해제할 때 증가 합니다.The count on a semaphore is decremented each time a thread enters the semaphore, and incremented when a thread releases the semaphore. 개수가 0 인 경우 후속 요청은 다른 스레드가 세마포를 해제할 때까지 차단 됩니다.When the count is zero, subsequent requests block until other threads release the semaphore. 모든 스레드가 세마포를 해제 한 경우 세마포가 생성 될 때 지정 된 최대값에 개수가 있습니다.When all threads have released the semaphore, the count is at the maximum value specified when the semaphore was created. 프로그래밍 오류로 인해 스레드가 Semaphore.Release 이 시점에서 메서드를 호출 하면이 SemaphoreFullException throw 됩니다.If a programming error causes a thread to call the Semaphore.Release method at this point, a SemaphoreFullException is thrown.

SemaphoreFullException 는 예외가 발생 한 코드에 문제가 있음을 나타내는 것은 아닙니다.SemaphoreFullException does not necessarily indicate a problem with the code where the exception occurred. 스레드 A와 스레드 B의 최대 수가 2 인 세마포를 입력 하는 시나리오를 살펴보겠습니다.Consider the following scenario: Thread A and thread B enter a semaphore that has a maximum count of two. 스레드 B에서 프로그래밍 오류가 발생 하면 Release 세마포의 개수가 full이 되도록 두 번 호출 됩니다.A programming error in thread B causes it to call Release twice, so that the count on the semaphore is full. 결과적으로 스레드 A Release 가를 호출 하면 SemaphoreFullException 이 throw 됩니다.As a result, when thread A eventually calls Release, a SemaphoreFullException is thrown.

SemaphoreFullException 클래스의 인스턴스에 대한 초기 속성 값 목록은 SemaphoreFullException() 생성자를 참조하십시오.For a list of initial property values for an instance of the SemaphoreFullException class, see the SemaphoreFullException() constructor.

생성자

속성

메서드

이벤트

적용 대상

추가 정보

• Semaphore
• 세마포Semaphore