Semaphore Konstruktory

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Inicializuje novou instanci Semaphore třídy.

Přetížení

Name	Description
Semaphore(Int32, Int32)	Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek.
Semaphore(Int32, Int32, String)	Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek a volitelně zadat název systémového semaphore objektu.
Semaphore(Int32, Int32, String, Boolean)	Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek, volitelně zadat název objektu semaphore systému a zadat proměnnou, která obdrží hodnotu určující, zda byl vytvořen nový systémový semaphore.
Semaphore(Int32, Int32, String, NamedWaitHandleOptions)	Inicializuje novou instanci Semaphore třídy, zadá počáteční počet položek a maximální počet souběžných položek a volitelně zadá název objektu semaphore systému a možnosti pro nastavení přístupu k oboru uživatele a relace.
Semaphore(Int32, Int32, String, NamedWaitHandleOptions, Boolean)	Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek, volitelně zadáním názvu objektu semaphore systému a možností pro nastavení uživatelského oboru a oboru relace a určení proměnné, která obdrží hodnotu určující, zda byl vytvořen nový systémový semaphore.

Semaphore(Int32, Int32)

Zdroj:

Semaphore.cs

Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek.

public:
 Semaphore(int initialCount, int maximumCount);

public Semaphore(int initialCount, int maximumCount);

new System.Threading.Semaphore : int * int -> System.Threading.Semaphore

Public Sub New (initialCount As Integer, maximumCount As Integer)

Parametry

initialCount

Int32

Počáteční počet požadavků na semafor, který lze současně udělit.

maximumCount

Int32

Maximální počet žádostí o semafor, který lze současně udělit.

Výjimky

ArgumentException

initialCount je větší než maximumCount.

ArgumentOutOfRangeException

maximumCount je menší než 1.

nebo

initialCount je menší než 0.

Příklady

Následující příklad vytvoří semaphore s maximálním počtem tří a počátečním počtem nuly. Příklad spustí pět vláken, které blok čekají na semafor. Hlavní vlákno používá Release(Int32) přetížení metody ke zvýšení počtu semaphore na jeho maximum, což umožňuje tři vlákna vstoupit do semaphore. Každé vlákno používá metodu Thread.Sleep k čekání na jednu sekundu, k simulaci práce a pak volá Release() přetížení metody k uvolnění semaphore. Při každém uvolnění semaforu se zobrazí předchozí semafor. Zprávy konzoly sledují použití semaphore. Simulovaný pracovní interval se pro každé vlákno mírně zvýší, aby se výstup snadněji četl.

using System;
using System.Threading;

public class Example
{
    // A semaphore that simulates a limited resource pool.
    //
    private static Semaphore _pool;

    // A padding interval to make the output more orderly.
    private static int _padding;

    public static void Main()
    {
        // Create a semaphore that can satisfy up to three
        // concurrent requests. Use an initial count of zero,
        // so that the entire semaphore count is initially
        // owned by the main program thread.
        //
        _pool = new Semaphore(initialCount: 0, maximumCount: 3);

        // Create and start five numbered threads. 
        //
        for(int i = 1; i <= 5; i++)
        {
            Thread t = new Thread(new ParameterizedThreadStart(Worker));

            // Start the thread, passing the number.
            //
            t.Start(i);
        }

        // Wait for half a second, to allow all the
        // threads to start and to block on the semaphore.
        //
        Thread.Sleep(500);

        // The main thread starts out holding the entire
        // semaphore count. Calling Release(3) brings the 
        // semaphore count back to its maximum value, and
        // allows the waiting threads to enter the semaphore,
        // up to three at a time.
        //
        Console.WriteLine("Main thread calls Release(3).");
        _pool.Release(releaseCount: 3);

        Console.WriteLine("Main thread exits.");
    }

    private static void Worker(object num)
    {
        // Each worker thread begins by requesting the
        // semaphore.
        Console.WriteLine("Thread {0} begins " +
            "and waits for the semaphore.", num);
        _pool.WaitOne();

        // A padding interval to make the output more orderly.
        int padding = Interlocked.Add(ref _padding, 100);

        Console.WriteLine("Thread {0} enters the semaphore.", num);
        
        // The thread's "work" consists of sleeping for 
        // about a second. Each thread "works" a little 
        // longer, just to make the output more orderly.
        //
        Thread.Sleep(1000 + padding);

        Console.WriteLine("Thread {0} releases the semaphore.", num);
        Console.WriteLine("Thread {0} previous semaphore count: {1}",
            num, _pool.Release());
    }
}

Imports System.Threading

Public Class Example

    ' A semaphore that simulates a limited resource pool.
    '
    Private Shared _pool As Semaphore

    ' A padding interval to make the output more orderly.
    Private Shared _padding As Integer

    <MTAThread> _
    Public Shared Sub Main()
        ' Create a semaphore that can satisfy up to three
        ' concurrent requests. Use an initial count of zero,
        ' so that the entire semaphore count is initially
        ' owned by the main program thread.
        '
        _pool = New Semaphore(0, 3)

        ' Create and start five numbered threads. 
        '
        For i As Integer = 1 To 5
            Dim t As New Thread(New ParameterizedThreadStart(AddressOf Worker))
            'Dim t As New Thread(AddressOf Worker)

            ' Start the thread, passing the number.
            '
            t.Start(i)
        Next i

        ' Wait for half a second, to allow all the
        ' threads to start and to block on the semaphore.
        '
        Thread.Sleep(500)

        ' The main thread starts out holding the entire
        ' semaphore count. Calling Release(3) brings the 
        ' semaphore count back to its maximum value, and
        ' allows the waiting threads to enter the semaphore,
        ' up to three at a time.
        '
        Console.WriteLine("Main thread calls Release(3).")
        _pool.Release(3)

        Console.WriteLine("Main thread exits.")
    End Sub

    Private Shared Sub Worker(ByVal num As Object)
        ' Each worker thread begins by requesting the
        ' semaphore.
        Console.WriteLine("Thread {0} begins " _
            & "and waits for the semaphore.", num)
        _pool.WaitOne()

        ' A padding interval to make the output more orderly.
        Dim padding As Integer = Interlocked.Add(_padding, 100)

        Console.WriteLine("Thread {0} enters the semaphore.", num)
        
        ' The thread's "work" consists of sleeping for 
        ' about a second. Each thread "works" a little 
        ' longer, just to make the output more orderly.
        '
        Thread.Sleep(1000 + padding)

        Console.WriteLine("Thread {0} releases the semaphore.", num)
        Console.WriteLine("Thread {0} previous semaphore count: {1}", _
            num, _
            _pool.Release())
    End Sub
End Class

Poznámky

Tento konstruktor inicializuje nepojmenovaný semaphore. Všechna vlákna, která používají instanci takového semaphore, musí mít odkazy na instanci.

Pokud initialCount je menší než maximumCount, účinek je stejný jako v případě, že aktuální vlákno volal WaitOne (maximumCount minus initialCount) krát. Pokud nechcete rezervovat žádné položky pro vlákno, které vytvoří semaphore, použijte stejné číslo pro maximumCount a initialCount.

Viz také

• spravovaných vláken
• Semafor

Semaphore(Int32, Int32, String)

Zdroj:

Semaphore.cs

Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek a volitelně zadat název systémového semaphore objektu.

public:
 Semaphore(int initialCount, int maximumCount, System::String ^ name);

public Semaphore(int initialCount, int maximumCount, string? name);

new System.Threading.Semaphore : int * int * string -> System.Threading.Semaphore

Public Sub New (initialCount As Integer, maximumCount As Integer, name As String)

Parametry

initialCount

Int32

Počáteční počet požadavků na semafor, který lze současně udělit.

maximumCount

Int32

Maximální počet žádostí o semafor, který lze současně udělit.

name

String

Název, pokud je synchronizační objekt sdílen s jinými procesy; null v opačném případě nebo prázdný řetězec. V názvu se rozlišují malá a velká písmena. Znak zpětného lomítka (\) je vyhrazen a lze ho použít pouze k určení oboru názvů. Další informace o oborech názvů najdete v části Poznámky. V závislosti na operačním systému můžou existovat další omezení názvu. Například v operačních systémech se systémem Unix musí být název po vyloučení oboru názvů platným názvem souboru.

Výjimky

ArgumentException

initialCount je větší než maximumCount.

nebo

pouze .NET Framework: name je delší než MAX_PATH (260 znaků).

ArgumentOutOfRangeException

maximumCount je menší než 1.

nebo

initialCount je menší než 0.

IOException

name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, například neznámé předpony nebo neplatné znaky. Všimněte si, že název a běžné předpony "Global\" a "Local\" rozlišují malá a velká písmena.

nebo

Došlo k nějaké jiné chybě. Vlastnost HResult může poskytnout další informace.

DirectoryNotFoundException

pouze Windows: name zadal neznámý obor názvů. Další informace najdete v tématu Názvy objektů .

PathTooLongException

name je příliš dlouhý. Omezení délky můžou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaný semaphore existuje a má zabezpečení řízení přístupu a uživatel nemá FullControl.

WaitHandleCannotBeOpenedException

Synchronizační objekt se zadaným objektem name nelze vytvořit. Synchronizační objekt jiného typu může mít stejný název.

Příklady

Následující příklad kódu ukazuje chování křížového procesu pojmenovaného semaphore. Příklad vytvoří pojmenovaný semaphore s maximálním počtem pěti a počátečním počtem pěti. Program provede tři volání metody WaitOne . Pokud tedy spustíte zkompilovaný příklad ze dvou oken příkazů, druhá kopie zablokuje třetí volání WaitOne. Uvolněte jednu nebo více položek v první kopii programu a odblokujte druhou.

using System;
using System.Threading;

public class Example
{
    public static void Main()
    {
        // Create a Semaphore object that represents the named 
        // system semaphore "SemaphoreExample3". The semaphore has a
        // maximum count of five. The initial count is also five. 
        // There is no point in using a smaller initial count,
        // because the initial count is not used if this program
        // doesn't create the named system semaphore, and with 
        // this method overload there is no way to tell. Thus, this
        // program assumes that it is competing with other
        // programs for the semaphore.
        //
        Semaphore sem = new Semaphore(5, 5, "SemaphoreExample3");

        // Attempt to enter the semaphore three times. If another 
        // copy of this program is already running, only the first
        // two requests can be satisfied. The third blocks. Note 
        // that in a real application, timeouts should be used
        // on the WaitOne calls, to avoid deadlocks.
        //
        sem.WaitOne();
        Console.WriteLine("Entered the semaphore once.");
        sem.WaitOne();
        Console.WriteLine("Entered the semaphore twice.");
        sem.WaitOne();
        Console.WriteLine("Entered the semaphore three times.");

        // The thread executing this program has entered the 
        // semaphore three times. If a second copy of the program
        // is run, it will block until this program releases the 
        // semaphore at least once.
        //
        Console.WriteLine("Enter the number of times to call Release.");
        int n;
        if (int.TryParse(Console.ReadLine(), out n))
        {
            sem.Release(n);
        }

        int remaining = 3 - n;
        if (remaining > 0)
        {
            Console.WriteLine("Press Enter to release the remaining " +
                "count ({0}) and exit the program.", remaining);
            Console.ReadLine();
            sem.Release(remaining);
        }
    }
}

Imports System.Threading

Public Class Example

    <MTAThread> _
    Public Shared Sub Main()
        ' Create a Semaphore object that represents the named 
        ' system semaphore "SemaphoreExample3". The semaphore has a
        ' maximum count of five. The initial count is also five. 
        ' There is no point in using a smaller initial count,
        ' because the initial count is not used if this program
        ' doesn't create the named system semaphore, and with 
        ' this method overload there is no way to tell. Thus, this
        ' program assumes that it is competing with other
        ' programs for the semaphore.
        '
        Dim sem As New Semaphore(5, 5, "SemaphoreExample3")

        ' Attempt to enter the semaphore three times. If another 
        ' copy of this program is already running, only the first
        ' two requests can be satisfied. The third blocks. Note 
        ' that in a real application, timeouts should be used
        ' on the WaitOne calls, to avoid deadlocks.
        '
        sem.WaitOne()
        Console.WriteLine("Entered the semaphore once.")
        sem.WaitOne()
        Console.WriteLine("Entered the semaphore twice.")
        sem.WaitOne()
        Console.WriteLine("Entered the semaphore three times.")

        ' The thread executing this program has entered the 
        ' semaphore three times. If a second copy of the program
        ' is run, it will block until this program releases the 
        ' semaphore at least once.
        '
        Console.WriteLine("Enter the number of times to call Release.")
        Dim n As Integer
        If Integer.TryParse(Console.ReadLine(), n) Then
            sem.Release(n)
        End If

        Dim remaining As Integer = 3 - n
        If (remaining) > 0 Then
            Console.WriteLine("Press Enter to release the remaining " _
                & "count ({0}) and exit the program.", remaining)
            Console.ReadLine()
            sem.Release(remaining)
        End If

    End Sub 
End Class

Poznámky

Tento konstruktor inicializuje Semaphore objekt, který představuje pojmenovaný systémový semaphore. Můžete vytvořit více Semaphore objektů, které představují stejný pojmenovaný systém semaphore.

Může name mít předponu Global\ nebo Local\ zadat obor názvů. Global Po zadání oboru názvů může být synchronizační objekt sdílen se všemi procesy v systému. Local Pokud je zadán obor názvů, což je také výchozí, pokud není zadán žádný obor názvů, synchronizační objekt může být sdílen s procesy ve stejné relaci. Na Windows je relace relace přihlášení a služby se obvykle spouští v jiné neinteraktivní relaci. V operačních systémech Unix má každé prostředí vlastní relaci. Objekty místní synchronizace relace můžou být vhodné pro synchronizaci mezi procesy s vztahem nadřazenosti nebo podřízenosti, kde se všechny spouští ve stejné relaci. Další informace o názvech synchronizačních objektů v Windows najdete v tématu Názvové objektyobjektu.

name Pokud je zadána a synchronizační objekt požadovaného typu již v oboru názvů existuje, použije se existující objekt synchronizace. Pokud synchronizační objekt jiného typu již v oboru názvů existuje, WaitHandleCannotBeOpenedException vyvolá se vyvolá. V opačném případě se vytvoří nový synchronizační objekt.

Pokud pojmenovaný systémový semaphore neexistuje, vytvoří se s počátečním počtem a maximálním počtem zadaným parametrem initialCount a maximumCount. Pokud pojmenovaný systémový semaphore již existuje initialCount a maximumCount nepoužívá se, i když neplatné hodnoty stále způsobují výjimky. Pokud potřebujete zjistit, zda byl vytvořen pojmenovaný systémový semaphore, použijte místo toho přetížení konstruktoru Semaphore(Int32, Int32, String, Boolean) .

Důležité

Při použití tohoto přetížení konstruktoru je doporučeným postupem zadat stejné číslo pro initialCount a maximumCount. Pokud initialCount je menší než maximumCounta pojmenovaný systémový semaphore je vytvořen, efekt je stejný jako v případě, že aktuální vlákno volal WaitOne (maximumCount minus initialCount) krát. S tímto přetížením konstruktoru však neexistuje způsob, jak určit, zda byl vytvořen pojmenovaný systémový semaphore.

Pokud zadáte null nebo prázdný řetězec pro name, místní semaphore je vytvořen, jako byste volali přetížení konstruktoru Semaphore(Int32, Int32) .

Vzhledem k tomu, že pojmenované semafory jsou viditelné v celém operačním systému, lze je použít ke koordinaci použití prostředků napříč hranicemi procesu.

Pokud chcete zjistit, zda pojmenovaný systémový semaphore existuje, použijte metodu OpenExisting . Metoda OpenExisting se pokusí otevřít existující pojmenovaný semaphore a vyvolá výjimku, pokud systémový semaphore neexistuje.

Caution

Ve výchozím nastavení není pojmenovaný semaphore omezen na uživatele, který ho vytvořil. Ostatní uživatelé můžou být schopni otevřít a použít semafor, včetně narušení semaforu tím, že ho několikrát získají a nevyvolá. Chcete-li omezit přístup na konkrétní uživatele, můžete použít přetížení konstruktoru nebo SemaphoreAcl předat při vytváření pojmenované SemaphoreSecurity semaphore. Nepoužívejte pojmenované semafory bez omezení přístupu v systémech, které můžou mít nedůvěryhodné uživatele se spuštěným kódem.

Viz také

• spravovaných vláken
• Semafor

Semaphore(Int32, Int32, String, Boolean)

Zdroj:

Semaphore.cs

Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek, volitelně zadat název objektu semaphore systému a zadat proměnnou, která obdrží hodnotu určující, zda byl vytvořen nový systémový semaphore.

public:
 Semaphore(int initialCount, int maximumCount, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew);

public Semaphore(int initialCount, int maximumCount, string? name, out bool createdNew);

new System.Threading.Semaphore : int * int * string * bool -> System.Threading.Semaphore

Public Sub New (initialCount As Integer, maximumCount As Integer, name As String, ByRef createdNew As Boolean)

Parametry

initialCount

Int32

Počáteční počet požadavků na semafor, který lze současně splnit.

maximumCount

Int32

Maximální počet požadavků na semafor, který lze současně splnit.

name

String

Název, pokud je synchronizační objekt sdílen s jinými procesy; null v opačném případě nebo prázdný řetězec. V názvu se rozlišují malá a velká písmena. Znak zpětného lomítka (\) je vyhrazen a lze ho použít pouze k určení oboru názvů. Další informace o oborech názvů najdete v části Poznámky. V závislosti na operačním systému můžou existovat další omezení názvu. Například v operačních systémech se systémem Unix musí být název po vyloučení oboru názvů platným názvem souboru.

createdNew

Boolean

Pokud tato metoda vrátí, obsahuje true , pokud byl vytvořen místní semaphore (to znamená, je-li name nebo null prázdný řetězec) nebo pokud zadaný pojmenovaný systémový semaphore byl vytvořen; false pokud zadaný pojmenovaný systém semaphore již existoval. Tento parametr se předává neinicializovaný.

Výjimky

ArgumentException

initialCount je větší než maximumCount.

nebo

pouze .NET Framework: name je delší než MAX_PATH (260 znaků).

ArgumentOutOfRangeException

maximumCount je menší než 1.

nebo

initialCount je menší než 0.

IOException

name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, například neznámé předpony nebo neplatné znaky. Všimněte si, že název a běžné předpony "Global\" a "Local\" rozlišují malá a velká písmena.

nebo

Došlo k nějaké jiné chybě. Vlastnost HResult může poskytnout další informace.

DirectoryNotFoundException

pouze Windows: name zadal neznámý obor názvů. Další informace najdete v tématu Názvy objektů .

PathTooLongException

name je příliš dlouhý. Omezení délky můžou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaný semaphore existuje a má zabezpečení řízení přístupu a uživatel nemá FullControl.

WaitHandleCannotBeOpenedException

Synchronizační objekt se zadaným objektem name nelze vytvořit. Synchronizační objekt jiného typu může mít stejný název.

Příklady

Následující příklad kódu ukazuje chování křížového procesu pojmenovaného semaphore. Příklad vytvoří pojmenovaný semaphore s maximálním počtem pěti a počátečním počtem dvou. To znamená, že vyhrazuje tři položky pro vlákno, které volá konstruktor. Pokud createNew ano false, program provede tři volání metody WaitOne . Pokud tedy spustíte zkompilovaný příklad ze dvou oken příkazů, druhá kopie zablokuje třetí volání WaitOne. Uvolněte jednu nebo více položek v první kopii programu a odblokujte druhou.

using System;
using System.Threading;

public class Example
{
    public static void Main()
    {
        // The value of this variable is set by the semaphore
        // constructor. It is true if the named system semaphore was
        // created, and false if the named semaphore already existed.
        //
        bool semaphoreWasCreated;

        // Create a Semaphore object that represents the named 
        // system semaphore "SemaphoreExample". The semaphore has a
        // maximum count of five, and an initial count of two. The
        // Boolean value that indicates creation of the underlying 
        // system object is placed in semaphoreWasCreated.
        //
        Semaphore sem = new Semaphore(2, 5, "SemaphoreExample", 
            out semaphoreWasCreated);

        if (semaphoreWasCreated)
        {
            // If the named system semaphore was created, its count is
            // set to the initial count requested in the constructor.
            // In effect, the current thread has entered the semaphore
            // three times.
            // 
            Console.WriteLine("Entered the semaphore three times.");
        }
        else
        {      
            // If the named system semaphore was not created,  
            // attempt to enter it three times. If another copy of
            // this program is already running, only the first two
            // requests can be satisfied. The third blocks.
            //
            sem.WaitOne();
            Console.WriteLine("Entered the semaphore once.");
            sem.WaitOne();
            Console.WriteLine("Entered the semaphore twice.");
            sem.WaitOne();
            Console.WriteLine("Entered the semaphore three times.");
        }

        // The thread executing this program has entered the 
        // semaphore three times. If a second copy of the program
        // is run, it will block until this program releases the 
        // semaphore at least once.
        //
        Console.WriteLine("Enter the number of times to call Release.");
        int n;
        if (int.TryParse(Console.ReadLine(), out n))
        {
            sem.Release(n);
        }

        int remaining = 3 - n;
        if (remaining > 0)
        {
            Console.WriteLine("Press Enter to release the remaining " +
                "count ({0}) and exit the program.", remaining);
            Console.ReadLine();
            sem.Release(remaining);
        }
    } 
}

Imports System.Threading

Public Class Example

    <MTAThread> _
    Public Shared Sub Main()
        ' The value of this variable is set by the semaphore
        ' constructor. It is True if the named system semaphore was
        ' created, and False if the named semaphore already existed.
        '
        Dim semaphoreWasCreated As Boolean

        ' Create a Semaphore object that represents the named 
        ' system semaphore "SemaphoreExample". The semaphore has a
        ' maximum count of five, and an initial count of two. The
        ' Boolean value that indicates creation of the underlying 
        ' system object is placed in semaphoreWasCreated.
        '
        Dim sem As New Semaphore(2, 5, "SemaphoreExample", _
            semaphoreWasCreated)

        If semaphoreWasCreated Then
            ' If the named system semaphore was created, its count is
            ' set to the initial count requested in the constructor.
            ' In effect, the current thread has entered the semaphore
            ' three times.
            ' 
            Console.WriteLine("Entered the semaphore three times.")
        Else
            ' If the named system semaphore was not created,  
            ' attempt to enter it three times. If another copy of
            ' this program is already running, only the first two
            ' requests can be satisfied. The third blocks.
            '
            sem.WaitOne()
            Console.WriteLine("Entered the semaphore once.")
            sem.WaitOne()
            Console.WriteLine("Entered the semaphore twice.")
            sem.WaitOne()
            Console.WriteLine("Entered the semaphore three times.")
        End If

        ' The thread executing this program has entered the 
        ' semaphore three times. If a second copy of the program
        ' is run, it will block until this program releases the 
        ' semaphore at least once.
        '
        Console.WriteLine("Enter the number of times to call Release.")
        Dim n As Integer
        If Integer.TryParse(Console.ReadLine(), n) Then
            sem.Release(n)
        End If

        Dim remaining As Integer = 3 - n
        If (remaining) > 0 Then
            Console.WriteLine("Press Enter to release the remaining " _
                & "count ({0}) and exit the program.", remaining)
            Console.ReadLine()
            sem.Release(remaining)
        End If

    End Sub 
End Class

Poznámky

Může name mít předponu Global\ nebo Local\ zadat obor názvů. Global Po zadání oboru názvů může být synchronizační objekt sdílen se všemi procesy v systému. Local Pokud je zadán obor názvů, což je také výchozí, pokud není zadán žádný obor názvů, synchronizační objekt může být sdílen s procesy ve stejné relaci. Na Windows je relace relace přihlášení a služby se obvykle spouští v jiné neinteraktivní relaci. V operačních systémech Unix má každé prostředí vlastní relaci. Objekty místní synchronizace relace můžou být vhodné pro synchronizaci mezi procesy s vztahem nadřazenosti nebo podřízenosti, kde se všechny spouští ve stejné relaci. Další informace o názvech synchronizačních objektů v Windows najdete v tématu Názvové objektyobjektu.

name Pokud je zadána a synchronizační objekt požadovaného typu již v oboru názvů existuje, použije se existující objekt synchronizace. Pokud synchronizační objekt jiného typu již v oboru názvů existuje, WaitHandleCannotBeOpenedException vyvolá se vyvolá. V opačném případě se vytvoří nový synchronizační objekt.

Tento konstruktor inicializuje Semaphore objekt, který představuje pojmenovaný systémový semaphore. Můžete vytvořit více Semaphore objektů, které představují stejný pojmenovaný systém semaphore.

Pokud pojmenovaný systémový semaphore neexistuje, vytvoří se s počátečním počtem a maximálním počtem zadaným parametrem initialCount a maximumCount. Pokud pojmenovaný systémový semaphore již existuje initialCount a maximumCount nepoužívá se, i když neplatné hodnoty stále způsobují výjimky. Slouží createdNew k určení, zda byl vytvořen systém semaphore.

Pokud initialCount je menší než maximumCounta createdNew je true, účinek je stejný jako v případě, že aktuální vlákno volal WaitOne (maximumCount minus initialCount) krát.

Pokud zadáte null nebo prázdný řetězec pro name, místní semaphore je vytvořen, jako byste volali přetížení konstruktoru Semaphore(Int32, Int32) . V tomto případě je createdNew vždy true.

Vzhledem k tomu, že pojmenované semafory jsou viditelné v celém operačním systému, lze je použít ke koordinaci použití prostředků napříč hranicemi procesu.

Caution

Ve výchozím nastavení není pojmenovaný semaphore omezen na uživatele, který ho vytvořil. Ostatní uživatelé můžou být schopni otevřít a použít semafor, včetně narušení semaforu tím, že ho několikrát získají a nevyvolá. Chcete-li omezit přístup na konkrétní uživatele, můžete použít přetížení konstruktoru nebo SemaphoreAcl předat při vytváření pojmenované SemaphoreSecurity semaphore. Nepoužívejte pojmenované semafory bez omezení přístupu v systémech, které můžou mít nedůvěryhodné uživatele se spuštěným kódem.

Viz také

• spravovaných vláken
• Semafor

Semaphore(Int32, Int32, String, NamedWaitHandleOptions)

Zdroj:

Semaphore.cs

Inicializuje novou instanci Semaphore třídy, zadá počáteční počet položek a maximální počet souběžných položek a volitelně zadá název objektu semaphore systému a možnosti pro nastavení přístupu k oboru uživatele a relace.

public:
 Semaphore(int initialCount, int maximumCount, System::String ^ name, System::Threading::NamedWaitHandleOptions options);

public Semaphore(int initialCount, int maximumCount, string? name, System.Threading.NamedWaitHandleOptions options);

new System.Threading.Semaphore : int * int * string * System.Threading.NamedWaitHandleOptions -> System.Threading.Semaphore

Public Sub New (initialCount As Integer, maximumCount As Integer, name As String, options As NamedWaitHandleOptions)

Parametry

initialCount

Int32

Počáteční počet požadavků na semafor, který lze současně splnit.

maximumCount

Int32

Maximální počet požadavků na semafor, který lze současně splnit.

name

String

Název, pokud je synchronizační objekt sdílen s jinými procesy; null v opačném případě nebo prázdný řetězec. V názvu se rozlišují malá a velká písmena.

options

NamedWaitHandleOptions

Možnosti oboru pojmenovaného semaforu. Ve výchozím nastavení je přístup omezený pouze na aktuálního uživatele a aktuální relaci. Zadané možnosti mohou ovlivnit obor názvů názvu a přístup k podkladovému objektu semaphore.

Výjimky

ArgumentException

initialCount je větší než maximumCount.

nebo

initialCount je menší než 0.

IOException

name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, například neznámé předpony nebo neplatné znaky. Všimněte si, že název a běžné předpony "Global\" a "Local\" rozlišují malá a velká písmena.

nebo

Došlo k nějaké jiné chybě. Vlastnost HResult může poskytnout další informace.

DirectoryNotFoundException

pouze Windows: name zadal neznámý obor názvů. Další informace najdete v tématu Názvy objektů .

PathTooLongException

name je příliš dlouhý. Omezení délky můžou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaný semaphore existuje a má zabezpečení řízení přístupu a uživatel nemá FullControl.

WaitHandleCannotBeOpenedException

Synchronizační objekt se zadaným objektem name nelze vytvořit. Synchronizační objekt jiného typu může mít stejný název.

nebo

Objekt se zadaným name objektem existuje, ale zadaný options objekt není kompatibilní s možnostmi existujícího objektu.

Poznámky

Tento konstruktor inicializuje Semaphore objekt, který představuje pojmenovaný systémový semaphore. Můžete vytvořit více Semaphore objektů, které představují stejný pojmenovaný systém semaphore.

name Pokud je zadán a synchronizační objekt požadovaného typu již v oboru názvů existuje, použije se existující synchronizační objekt, pokud options neurčí přístup omezený na aktuálního uživatele a synchronizační objekt není kompatibilní s ním, v takovém případě WaitHandleCannotBeOpenedException je vyvolán. Pokud synchronizační objekt jiného typu již v oboru názvů existuje, WaitHandleCannotBeOpenedException vyvolá se i objekt synchronizace. V opačném případě se vytvoří nový synchronizační objekt.

Pokud pojmenovaný systémový semaphore neexistuje, vytvoří se s počátečním počtem a maximálním počtem zadaným parametrem initialCount a maximumCount. Pokud pojmenovaný systémový semaphore již existuje initialCount a maximumCount nepoužívá se, i když neplatné hodnoty stále způsobují výjimky. Pokud potřebujete zjistit, zda byl vytvořen pojmenovaný systémový semaphore, použijte místo toho přetížení konstruktoru Semaphore(Int32, Int32, String, Boolean) .

Důležité

Při použití tohoto přetížení konstruktoru je doporučeným postupem zadat stejné číslo pro initialCount a maximumCount. Pokud initialCount je menší než maximumCounta pojmenovaný systémový semaphore je vytvořen, efekt je stejný jako v případě, že aktuální vlákno volal WaitOne (maximumCount minus initialCount) krát. S tímto přetížením konstruktoru však neexistuje způsob, jak určit, zda byl vytvořen pojmenovaný systémový semaphore.

Pokud zadáte null nebo prázdný řetězec pro name, místní semaphore je vytvořen, jako byste volali přetížení konstruktoru Semaphore(Int32, Int32) .

Vzhledem k tomu, že pojmenované semafory jsou viditelné v celém operačním systému, lze je použít ke koordinaci použití prostředků napříč hranicemi procesu.

Pokud chcete zjistit, zda pojmenovaný systémový semaphore existuje, použijte metodu OpenExisting . Metoda OpenExisting se pokusí otevřít existující pojmenovaný semaphore a vyvolá výjimku, pokud systémový semaphore neexistuje.

V Windows lze zadat options a určit, jestli je pojmenovaný semaphore přístupný pouze aktuálnímu uživateli nebo všem uživatelům. Umožňuje také určit, zda je pojmenovaný semaphore přístupný pro procesy pouze v aktuální relaci nebo pro všechny relace. Další informace najdete na webu NamedWaitHandleOptions.

Caution

V operačních systémech se systémem Unix nemá parametr žádný vliv, options protože pojmenované semafory nejsou podporovány.

Viz také

• spravovaných vláken
• Semafor

Semaphore(Int32, Int32, String, NamedWaitHandleOptions, Boolean)

Zdroj:

Semaphore.cs

Inicializuje novou instanci Semaphore třídy, určuje počáteční počet položek a maximální počet souběžných položek, volitelně zadáním názvu objektu semaphore systému a možností pro nastavení uživatelského oboru a oboru relace a určení proměnné, která obdrží hodnotu určující, zda byl vytvořen nový systémový semaphore.

public:
 Semaphore(int initialCount, int maximumCount, System::String ^ name, System::Threading::NamedWaitHandleOptions options, [Runtime::InteropServices::Out] bool % createdNew);

public Semaphore(int initialCount, int maximumCount, string? name, System.Threading.NamedWaitHandleOptions options, out bool createdNew);

new System.Threading.Semaphore : int * int * string * System.Threading.NamedWaitHandleOptions * bool -> System.Threading.Semaphore

Public Sub New (initialCount As Integer, maximumCount As Integer, name As String, options As NamedWaitHandleOptions, ByRef createdNew As Boolean)

Parametry

initialCount

Int32

Počáteční počet požadavků na semafor, který lze současně splnit.

maximumCount

Int32

Maximální počet požadavků na semafor, který lze současně splnit.

name

String

Název, pokud je synchronizační objekt sdílen s jinými procesy; null v opačném případě nebo prázdný řetězec. V názvu se rozlišují malá a velká písmena.

options

NamedWaitHandleOptions

Možnosti oboru pojmenovaného semaforu. Ve výchozím nastavení je přístup omezený pouze na aktuálního uživatele a aktuální relaci. Zadané možnosti mohou ovlivnit obor názvů názvu a přístup k podkladovému objektu semaphore.

createdNew

Boolean

Pokud tato metoda vrátí, obsahuje true , pokud byl vytvořen místní semaphore (to znamená, je-li namenull nebo prázdný řetězec) nebo pokud zadaný pojmenovaný systémový semaphore byl vytvořen; obsahuje false , pokud zadaný pojmenovaný semaphore již existoval. Tento parametr se předává neinicializovaný.

Výjimky

ArgumentException

initialCount je větší než maximumCount.

nebo

initialCount je menší než 0.

IOException

name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, například neznámé předpony nebo neplatné znaky. Všimněte si, že název a běžné předpony "Global\" a "Local\" rozlišují malá a velká písmena.

nebo

Došlo k nějaké jiné chybě. Vlastnost HResult může poskytnout další informace.

DirectoryNotFoundException

pouze Windows: name zadal neznámý obor názvů. Další informace najdete v tématu Názvy objektů .

PathTooLongException

name je příliš dlouhý. Omezení délky můžou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaný semaphore existuje a má zabezpečení řízení přístupu a uživatel nemá FullControl.

WaitHandleCannotBeOpenedException

Synchronizační objekt se zadaným objektem name nelze vytvořit. Synchronizační objekt jiného typu může mít stejný název.

nebo

Objekt se zadaným name objektem existuje, ale zadaný options objekt není kompatibilní s možnostmi existujícího objektu.

Poznámky

name Pokud je zadán a synchronizační objekt požadovaného typu již v oboru názvů existuje, použije se existující synchronizační objekt, pokud options neurčí přístup omezený na aktuálního uživatele a synchronizační objekt není kompatibilní s ním, v takovém případě WaitHandleCannotBeOpenedException je vyvolán. Pokud synchronizační objekt jiného typu již v oboru názvů existuje, WaitHandleCannotBeOpenedException vyvolá se i objekt synchronizace. V opačném případě se vytvoří nový synchronizační objekt.

Tento konstruktor inicializuje Semaphore objekt, který představuje pojmenovaný systémový semaphore. Můžete vytvořit více Semaphore objektů, které představují stejný pojmenovaný systém semaphore.

Pokud pojmenovaný systémový semaphore neexistuje, vytvoří se s počátečním počtem a maximálním počtem zadaným parametrem initialCount a maximumCount. Pokud pojmenovaný systémový semaphore již existuje initialCount a maximumCount nepoužívá se, i když neplatné hodnoty stále způsobují výjimky. Pomocí parametru createdNew určete, zda byl systém semaphore vytvořen tímto konstruktorem.

Pokud initialCount je menší než maximumCounta createdNew je true, účinek je stejný jako v případě, že aktuální vlákno volal WaitOne (maximumCount minus initialCount) krát.

Pokud zadáte null nebo prázdný řetězec pro name, místní semaphore je vytvořen, jako byste volali přetížení konstruktoru Semaphore(Int32, Int32) . V tomto případě je createdNew vždy true.

Vzhledem k tomu, že pojmenované semafory jsou viditelné v celém operačním systému, lze je použít ke koordinaci použití prostředků napříč hranicemi procesu.

V Windows lze zadat options a určit, jestli je pojmenovaný semaphore přístupný pouze aktuálnímu uživateli nebo všem uživatelům. Umožňuje také určit, zda je pojmenovaný semaphore přístupný pro procesy pouze v aktuální relaci nebo pro všechny relace. Další informace najdete na webu NamedWaitHandleOptions.

Caution

V operačních systémech se systémem Unix nemá parametr žádný vliv, options protože pojmenované semafory nejsou podporovány.

Viz také

• spravovaných vláken
• Semafor