SemaphoreFullException Třída

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Zdroj:

SemaphoreFullException.cs

Výjimka, která je vyvolána při Release vyvolání metody v semaphore, jehož počet je již maximální.

public ref class SemaphoreFullException : SystemException

public class SemaphoreFullException : SystemException

type SemaphoreFullException = class
    inherit SystemException

Public Class SemaphoreFullException
Inherits SystemException

Dědičnost

Object

Exception

SystemException

SemaphoreFullException

Příklady

Následující příklad kódu ukazuje, jak programovací chyba v jednom vlákně může vést k SemaphoreFullException jinému vláknu: Dvě vlákna zadávají semafor. Druhé vlákno uvolní semaphore dvakrát, zatímco první vlákno stále spouští svou úlohu. Jakmile se první vlákno dokončí a uvolní semaphore, počet semaphore je již plný a vyvolá se výjimka.

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

Poznámky

Počet semaforu se při každém vstupu vlákna do semaforu sníží a zvýší se, když vlákno uvolní semaphore. Pokud je počet nula, následné požadavky blokují, dokud ostatní vlákna nevolí semafor. Když všechna vlákna uvolní semaphore, počet je maximální hodnota zadaná při vytvoření semaforu. Pokud programovací chyba způsobí, že vlákno zavolá metodu v tomto okamžiku Semaphore.ReleaseSemaphoreFullException , vyvolá se vyvolá.

Note

Třída Semaphore nevynucuje identitu vlákna pro volání WaitHandle.WaitOne a Semaphore.Release metody. Není nutné pro stejné vlákno, které volal WaitOne volání Release.

SemaphoreFullException nemusí nutně znamenat problém s kódem, kde došlo k výjimce. Představte si následující scénář: Vlákno A a vlákno B zadejte semaphore, který má maximální počet dvou. Programovací chyba ve vlákně B způsobí, že se volá Release dvakrát, takže počet na semaforu je plný. V důsledku toho, když vlákno A nakonec volá Release, SemaphoreFullException je vyvolán.

Seznam počátečních hodnot vlastností pro instanci SemaphoreFullException třídy naleznete v konstruktoru SemaphoreFullException() .

Konstruktory

Name	Description
SemaphoreFullException()	Inicializuje novou instanci SemaphoreFullException třídy s výchozími hodnotami.
SemaphoreFullException(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci SemaphoreFullException třídy serializovanými daty.
SemaphoreFullException(String, Exception)	Inicializuje novou instanci SemaphoreFullException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.
SemaphoreFullException(String)	Inicializuje novou instanci SemaphoreFullException třídy se zadanou chybovou zprávou.

Vlastnosti

Name	Description
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Při přepsání v odvozené třídě nastaví SerializationInfo s informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• Semaphore
• Semafor