Semaphore Oluşturucular

Tanım

Ad Alanı:

System.Threading

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Threading.dll

Semaphore sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
Semaphore(Int32, Int32)	İlk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirterek sınıfının yeni bir örneğini Semaphore başlatır.
Semaphore(Int32, Int32, String)	İlk girdi sayısını ve eşzamanlı girdi sayısı üst sınırını belirterek ve isteğe bağlı olarak sistem semafor nesnesinin adını belirterek sınıfının yeni bir örneğini Semaphore başlatır.
Semaphore(Int32, Int32, String, Boolean)	sınıfının yeni bir örneğini Semaphore başlatır, ilk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirtir, isteğe bağlı olarak sistem semafor nesnesinin adını belirtir ve yeni bir sistem semaforunun oluşturulup oluşturulmadığını belirten bir değer alan bir değişken belirtir.
Semaphore(Int32, Int32, String, NamedWaitHandleOptions)	İlk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirterek ve isteğe bağlı olarak kullanıcı kapsamı ve oturum kapsamı erişimini ayarlamak için sistem semafor nesnesinin adını ve seçeneklerini belirterek sınıfın yeni bir örneğini Semaphore başlatır.
Semaphore(Int32, Int32, String, NamedWaitHandleOptions, Boolean)	Sınıfının yeni bir örneğini Semaphore başlatır, ilk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirtir, isteğe bağlı olarak sistem semafor nesnesinin adını ve kullanıcı kapsamı ve oturum kapsamı erişimini ayarlama seçeneklerini belirtir ve yeni bir sistem semaforunun oluşturulup oluşturulmadığını belirten bir değer alan bir değişken belirtir.

Semaphore(Int32, Int32)

Kaynak:

Semaphore.cs

İlk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirterek sınıfının yeni bir örneğini Semaphore başlatır.

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)

Parametreler

initialCount

Int32

Semafor için eşzamanlı olarak verilebilen ilk istek sayısı.

maximumCount

Int32

Semafor için eşzamanlı olarak verilebilen en fazla istek sayısı.

Özel durumlar

ArgumentException

initialCount değerinden maximumCountbüyüktür.

ArgumentOutOfRangeException

maximumCount 1'den küçüktür.

-veya-

initialCount 0'dan küçüktür.

Örnekler

Aşağıdaki örnek, en fazla üç sayısı ve ilk sayısı sıfır olan bir semafor oluşturur. Örnek, semaforu bekleyen beş iş parçacığını başlatır. Ana iş parçacığı, semafor sayısını maksimuma yükseltmek için yöntem aşırı yüklemesini kullanarak Release(Int32) üç iş parçacığının semafora girmesini sağlar. Her iş parçacığı, çalışmayı simüle etmek için bir saniye beklemek için yöntemini kullanır Thread.Sleep ve ardından semaforu serbest bırakmak için yöntem aşırı yüklemesini çağırır Release() . Semafor her serbest bırakıldığında, önceki semafor sayısı görüntülenir. Konsol iletileri semafor kullanımını izler. Simülasyon çalışma aralığı, çıkışın okunmasını kolaylaştırmak için her iş parçacığı için biraz artırılır.

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

Açıklamalar

Bu oluşturucu adsız bir semafor başlatır. Böyle bir semaforun örneğini kullanan tüm iş parçacıklarının örneğe başvuruları olmalıdır.

değerinden küçükse initialCountmaximumCount, geçerli iş parçacığının WaitOne çağrılma sayısı (maximumCount eksi initialCount) ile aynıdır. Semafor oluşturan iş parçacığı için herhangi bir girdi ayırmak istemiyorsanız ve maximumCountiçin initialCount aynı sayıyı kullanın.

Ayrıca bkz.

• Yönetilen İş Parçacıkları
• Semafor

Semaphore(Int32, Int32, String)

Kaynak:

Semaphore.cs

İlk girdi sayısını ve eşzamanlı girdi sayısı üst sınırını belirterek ve isteğe bağlı olarak sistem semafor nesnesinin adını belirterek sınıfının yeni bir örneğini Semaphore başlatır.

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)

Parametreler

initialCount

Int32

Semafor için eşzamanlı olarak verilebilen ilk istek sayısı.

maximumCount

Int32

Semafor için eşzamanlı olarak verilebilen en fazla istek sayısı.

name

String

Eşitleme nesnesi diğer işlemlerle paylaşılacaksa ad; null veya boş bir dize. Ad büyük/küçük harfe duyarlıdır. Ters eğik çizgi karakteri (\) ayrılmıştır ve yalnızca bir ad alanı belirtmek için kullanılabilir. Ad alanları hakkında daha fazla bilgi için açıklamalar bölümüne bakın. İşletim sistemine bağlı olarak ad üzerinde başka kısıtlamalar da olabilir. Örneğin, Unix tabanlı işletim sistemlerinde, ad alanı dışlanmadan sonraki ad geçerli bir dosya adı olmalıdır.

Özel durumlar

ArgumentException

initialCount değerinden maximumCountbüyüktür.

-veya-

Yalnızca .NET Framework: name MAX_PATH'den (260 karakter) uzundur.

ArgumentOutOfRangeException

maximumCount 1'den küçüktür.

-veya-

initialCount 0'dan küçüktür.

IOException

name geçersiz. Bu, bilinmeyen ön ek veya geçersiz karakterler gibi işletim sistemi tarafından yerleştirilebilen bazı kısıtlamalar da dahil olmak üzere çeşitli nedenlerle olabilir. Adın ve "Genel\" ve "Yerel\" ortak ön eklerinin büyük/küçük harfe duyarlı olduğunu unutmayın.

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

DirectoryNotFoundException

Yalnızca Windows: name bilinmeyen bir ad alanı belirtti. Daha fazla bilgi için bkz. Nesne Adları .

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış semafor var ve erişim denetimi güvenliğine sahip ve kullanıcının yok FullControl.

WaitHandleCannotBeOpenedException

Sağlanan name ile bir eşitleme nesnesi oluşturulamıyor. Farklı türde bir eşitleme nesnesi aynı ada sahip olabilir.

Örnekler

Aşağıdaki kod örneği, adlandırılmış bir semaforun işlemler arası davranışını gösterir. Örnek, en fazla beş ve ilk sayısı beş olan adlandırılmış bir semafor oluşturur. Program yöntemine WaitOne üç çağrı yapar. Bu nedenle, derlenmiş örneği iki komut penceresiyle çalıştırırsanız, ikinci kopya üçüncü çağrısında WaitOneöğesini engeller. İkincinin engelini kaldırmak için programın ilk kopyasındaki bir veya daha fazla girdiyi serbest bırakın.

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

Açıklamalar

Bu oluşturucu, adlandırılmış bir Semaphore sistem semaforu temsil eden bir nesne başlatır. Aynı adlandırılmış sistem semaforunu temsil eden birden çok Semaphore nesne oluşturabilirsiniz.

name bir ad alanı belirtmek için veya Global\ ön ekine Local\ sahip olabilir. Ad alanı belirtildiğinde Global , eşitleme nesnesi sistemdeki tüm işlemlerle paylaşılabilir. Local Ad alanı belirtilmediğinde de varsayılan olan ad alanı belirtildiğinde, eşitleme nesnesi aynı oturumdaki işlemlerle paylaşılabilir. Windows oturum, oturum açma oturumudur ve hizmetler genellikle etkileşimli olmayan farklı bir oturumda çalışır. Unix benzeri işletim sistemlerinde her kabuğun kendi oturumu vardır. Oturum yerel eşitleme nesneleri, tümü aynı oturumda çalıştırıldığı bir üst/alt ilişki ile işlemler arasında eşitleme için uygun olabilir. Windows eşitleme nesnesi adları hakkında daha fazla bilgi için bkz. Object Names.

bir name sağlanırsa ve istenen türdeki bir eşitleme nesnesi ad alanında zaten varsa, mevcut eşitleme nesnesi kullanılır. Ad alanında farklı türde bir eşitleme nesnesi zaten varsa, bir WaitHandleCannotBeOpenedException oluşturulur. Aksi takdirde, yeni bir eşitleme nesnesi oluşturulur.

Adlandırılmış sistem semaforu yoksa, ve initialCounttarafından maximumCount belirtilen ilk sayı ve maksimum sayı ile oluşturulur. Adlandırılmış sistem semaforu zaten varsa initialCount ve maximumCount kullanılmazsa, ancak geçersiz değerler yine de özel durumlara neden olur. Adlandırılmış bir sistem semaforunun oluşturulup oluşturulmadığını belirlemeniz gerekiyorsa, bunun yerine oluşturucu aşırı yüklemesini Semaphore(Int32, Int32, String, Boolean) kullanın.

Important

Bu oluşturucu aşırı yüklemesini kullandığınızda, önerilen yöntem ve initialCountiçin maximumCount aynı sayıyı belirtmektir. değerinden initialCountküçükse ve adlandırılmış bir sistem semaforu oluşturulduysamaximumCount, geçerli iş parçacığının çağrılma WaitOne sayısı (maximumCount eksi initialCount) ile aynıdır. Ancak, bu oluşturucu aşırı yüklemesiyle adlandırılmış bir sistem semaforu oluşturulup oluşturulmadığını belirlemenin hiçbir yolu yoktur.

için veya için boş bir dize nullbelirtirsenizname, oluşturucu aşırı yüklemesini çağırmış Semaphore(Int32, Int32) gibi yerel bir semafor oluşturulur.

Adlandırılmış semaforlar işletim sistemi genelinde görünür olduğundan, kaynak kullanımını işlem sınırları arasında koordine etmek için kullanılabilirler.

Adlandırılmış bir sistem semaforunun var olup olmadığını öğrenmek istiyorsanız yöntemini kullanın OpenExisting . OpenExisting yöntemi, mevcut adlı semaforu açmayı dener ve sistem semaforu yoksa bir özel durum oluşturur.

Caution

Varsayılan olarak, adlandırılmış bir semafor onu oluşturan kullanıcıyla sınırlı değildir. Diğer kullanıcılar semaforu birden çok kez alarak ve serbest bırakmayarak semafora müdahale etmek de dahil olmak üzere semaforu açabilir ve kullanabilir. Erişimi belirli kullanıcılara kısıtlamak için bir oluşturucu aşırı yüklemesini kullanabilir veya SemaphoreAcl adlandırılmış semaforu oluştururken bir SemaphoreSecurity geçirebilirsiniz. Kod çalıştıran güvenilmeyen kullanıcılara sahip olabilecek sistemlerde erişim kısıtlamaları olmadan adlandırılmış semafor kullanmaktan kaçının.

Ayrıca bkz.

• Yönetilen İş Parçacıkları
• Semafor

Semaphore(Int32, Int32, String, Boolean)

Kaynak:

Semaphore.cs

sınıfının yeni bir örneğini Semaphore başlatır, ilk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirtir, isteğe bağlı olarak sistem semafor nesnesinin adını belirtir ve yeni bir sistem semaforunun oluşturulup oluşturulmadığını belirten bir değer alan bir değişken belirtir.

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)

Parametreler

initialCount

Int32

Semafor için eşzamanlı olarak karşılanabilen ilk istek sayısı.

maximumCount

Int32

Semafor için eşzamanlı olarak karşılanabilecek en fazla istek sayısı.

name

String

Eşitleme nesnesi diğer işlemlerle paylaşılacaksa ad; null veya boş bir dize. Ad büyük/küçük harfe duyarlıdır. Ters eğik çizgi karakteri (\) ayrılmıştır ve yalnızca bir ad alanı belirtmek için kullanılabilir. Ad alanları hakkında daha fazla bilgi için açıklamalar bölümüne bakın. İşletim sistemine bağlı olarak ad üzerinde başka kısıtlamalar da olabilir. Örneğin, Unix tabanlı işletim sistemlerinde, ad alanı dışlanmadan sonraki ad geçerli bir dosya adı olmalıdır.

createdNew

Boolean

Bu yöntem döndürdüğünde, yerel bir semafor oluşturulup oluşturulmadığını (varsa truename veya boş bir dizeyse) veya belirtilen adlandırılmış sistem semaforunun oluşturulup oluşturulmadığını; null belirtilen adlandırılmış sistem semaforunun zaten mevcut olup olmadığını içerirfalse. Bu parametre başlatılmamış olarak geçirilir.

Özel durumlar

ArgumentException

initialCount değerinden maximumCountbüyüktür.

-veya-

Yalnızca .NET Framework: name MAX_PATH'den (260 karakter) uzundur.

ArgumentOutOfRangeException

maximumCount 1'den küçüktür.

-veya-

initialCount 0'dan küçüktür.

IOException

name geçersiz. Bu, bilinmeyen ön ek veya geçersiz karakterler gibi işletim sistemi tarafından yerleştirilebilen bazı kısıtlamalar da dahil olmak üzere çeşitli nedenlerle olabilir. Adın ve "Genel\" ve "Yerel\" ortak ön eklerinin büyük/küçük harfe duyarlı olduğunu unutmayın.

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

DirectoryNotFoundException

Yalnızca Windows: name bilinmeyen bir ad alanı belirtti. Daha fazla bilgi için bkz. Nesne Adları .

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış semafor var ve erişim denetimi güvenliğine sahip ve kullanıcının yok FullControl.

WaitHandleCannotBeOpenedException

Sağlanan name ile bir eşitleme nesnesi oluşturulamıyor. Farklı türde bir eşitleme nesnesi aynı ada sahip olabilir.

Örnekler

Aşağıdaki kod örneği, adlandırılmış bir semaforun işlemler arası davranışını gösterir. Örnek, en fazla beş ve ilk sayısı iki olan adlandırılmış bir semafor oluşturur. Başka bir ifadeyle, oluşturucuyu çağıran iş parçacığı için üç giriş ayırır. ise createNewfalse, program yöntemine WaitOne üç çağrı yapar. Bu nedenle, derlenmiş örneği iki komut penceresiyle çalıştırırsanız, ikinci kopya üçüncü çağrısında WaitOneöğesini engeller. İkincinin engelini kaldırmak için programın ilk kopyasındaki bir veya daha fazla girdiyi serbest bırakın.

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

Açıklamalar

name bir ad alanı belirtmek için veya Global\ ön ekine Local\ sahip olabilir. Ad alanı belirtildiğinde Global , eşitleme nesnesi sistemdeki tüm işlemlerle paylaşılabilir. Local Ad alanı belirtilmediğinde de varsayılan olan ad alanı belirtildiğinde, eşitleme nesnesi aynı oturumdaki işlemlerle paylaşılabilir. Windows oturum, oturum açma oturumudur ve hizmetler genellikle etkileşimli olmayan farklı bir oturumda çalışır. Unix benzeri işletim sistemlerinde her kabuğun kendi oturumu vardır. Oturum yerel eşitleme nesneleri, tümü aynı oturumda çalıştırıldığı bir üst/alt ilişki ile işlemler arasında eşitleme için uygun olabilir. Windows eşitleme nesnesi adları hakkında daha fazla bilgi için bkz. Object Names.

bir name sağlanırsa ve istenen türdeki bir eşitleme nesnesi ad alanında zaten varsa, mevcut eşitleme nesnesi kullanılır. Ad alanında farklı türde bir eşitleme nesnesi zaten varsa, bir WaitHandleCannotBeOpenedException oluşturulur. Aksi takdirde, yeni bir eşitleme nesnesi oluşturulur.

Bu oluşturucu, adlandırılmış bir Semaphore sistem semaforu temsil eden bir nesne başlatır. Aynı adlandırılmış sistem semaforunu temsil eden birden çok Semaphore nesne oluşturabilirsiniz.

Adlandırılmış sistem semaforu yoksa, ve initialCounttarafından maximumCount belirtilen ilk sayı ve maksimum sayı ile oluşturulur. Adlandırılmış sistem semaforu zaten varsa initialCount ve maximumCount kullanılmazsa, ancak geçersiz değerler yine de özel durumlara neden olur. Sistem semaforunun oluşturulup oluşturulmadığını belirlemek için kullanın createdNew .

değerinden küçükse initialCount ve maximumCount isecreatedNew, etki geçerli iş parçacığının (true eksi WaitOne) kez çağrılmış maximumCount olmasıyla aynıdır.initialCount

için veya için boş bir dize nullbelirtirsenizname, oluşturucu aşırı yüklemesini çağırmış Semaphore(Int32, Int32) gibi yerel bir semafor oluşturulur. Bu durumda, createdNew her zaman trueolur.

Adlandırılmış semaforlar işletim sistemi genelinde görünür olduğundan, kaynak kullanımını işlem sınırları arasında koordine etmek için kullanılabilirler.

Caution

Varsayılan olarak, adlandırılmış bir semafor onu oluşturan kullanıcıyla sınırlı değildir. Diğer kullanıcılar semaforu birden çok kez alarak ve serbest bırakmayarak semafora müdahale etmek de dahil olmak üzere semaforu açabilir ve kullanabilir. Erişimi belirli kullanıcılara kısıtlamak için bir oluşturucu aşırı yüklemesini kullanabilir veya SemaphoreAcl adlandırılmış semaforu oluştururken bir SemaphoreSecurity geçirebilirsiniz. Kod çalıştıran güvenilmeyen kullanıcılara sahip olabilecek sistemlerde erişim kısıtlamaları olmadan adlandırılmış semafor kullanmaktan kaçının.

Ayrıca bkz.

• Yönetilen İş Parçacıkları
• Semafor

Semaphore(Int32, Int32, String, NamedWaitHandleOptions)

Kaynak:

Semaphore.cs

İlk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirterek ve isteğe bağlı olarak kullanıcı kapsamı ve oturum kapsamı erişimini ayarlamak için sistem semafor nesnesinin adını ve seçeneklerini belirterek sınıfın yeni bir örneğini Semaphore başlatır.

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)

Parametreler

initialCount

Int32

Semafor için eşzamanlı olarak karşılanabilen ilk istek sayısı.

maximumCount

Int32

Semafor için eşzamanlı olarak karşılanabilecek en fazla istek sayısı.

name

String

Eşitleme nesnesi diğer işlemlerle paylaşılacaksa ad; null veya boş bir dize. Ad büyük/küçük harfe duyarlıdır.

options

NamedWaitHandleOptions

Adlandırılmış semafor için kapsam seçenekleri. Varsayılan erişim yalnızca geçerli kullanıcı ve geçerli oturum ile sınırlıdır. Belirtilen seçenekler, adın ad alanını ve temel alınan semafor nesnesine erişimi etkileyebilir.

Özel durumlar

ArgumentException

initialCount değerinden maximumCountbüyüktür.

-veya-

initialCount 0'dan küçüktür.

IOException

name geçersiz. Bu, bilinmeyen ön ek veya geçersiz karakterler gibi işletim sistemi tarafından yerleştirilebilen bazı kısıtlamalar da dahil olmak üzere çeşitli nedenlerle olabilir. Adın ve "Genel\" ve "Yerel\" ortak ön eklerinin büyük/küçük harfe duyarlı olduğunu unutmayın.

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

DirectoryNotFoundException

Yalnızca Windows: name bilinmeyen bir ad alanı belirtti. Daha fazla bilgi için bkz. Nesne Adları .

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış semafor var ve erişim denetimi güvenliğine sahip ve kullanıcının yok FullControl.

WaitHandleCannotBeOpenedException

Sağlanan name ile bir eşitleme nesnesi oluşturulamıyor. Farklı türde bir eşitleme nesnesi aynı ada sahip olabilir.

-veya-

Belirtilene name sahip bir nesne var, ancak belirtilen options nesne var olan nesnenin seçenekleriyle uyumlu değil.

Açıklamalar

Bu oluşturucu, adlandırılmış bir Semaphore sistem semaforu temsil eden bir nesne başlatır. Aynı adlandırılmış sistem semaforunu temsil eden birden çok Semaphore nesne oluşturabilirsiniz.

bir name sağlanırsa ve istenen türün eşitleme nesnesi ad alanında zaten varsa, geçerli kullanıcıyla sınırlı erişim belirtilmediği ve eşitleme nesnesinin onunla uyumlu olmadığı sürece options mevcut eşitleme nesnesi kullanılır ve bu durumda bir WaitHandleCannotBeOpenedException oluşturulur. Ad alanında farklı türde bir eşitleme nesnesi zaten varsa, bir WaitHandleCannotBeOpenedException de oluşturulur. Aksi takdirde, yeni bir eşitleme nesnesi oluşturulur.

Adlandırılmış sistem semaforu yoksa, ve initialCounttarafından maximumCount belirtilen ilk sayı ve maksimum sayı ile oluşturulur. Adlandırılmış sistem semaforu zaten varsa initialCount ve maximumCount kullanılmazsa, ancak geçersiz değerler yine de özel durumlara neden olur. Adlandırılmış bir sistem semaforunun oluşturulup oluşturulmadığını belirlemeniz gerekiyorsa, bunun yerine oluşturucu aşırı yüklemesini Semaphore(Int32, Int32, String, Boolean) kullanın.

Important

Bu oluşturucu aşırı yüklemesini kullandığınızda, önerilen yöntem ve initialCountiçin maximumCount aynı sayıyı belirtmektir. değerinden initialCountküçükse ve adlandırılmış bir sistem semaforu oluşturulduysamaximumCount, geçerli iş parçacığının çağrılma WaitOne sayısı (maximumCount eksi initialCount) ile aynıdır. Ancak bu oluşturucu aşırı yüklemesiyle adlandırılmış bir sistem semaforu oluşturulup oluşturulmadığını belirlemenin bir yolu yoktur.

için veya için boş bir dize nullbelirtirsenizname, oluşturucu aşırı yüklemesini çağırmış Semaphore(Int32, Int32) gibi yerel bir semafor oluşturulur.

Adlandırılmış semaforlar işletim sistemi genelinde görünür olduğundan, kaynak kullanımını işlem sınırları arasında koordine etmek için kullanılabilirler.

Adlandırılmış bir sistem semaforunun var olup olmadığını öğrenmek istiyorsanız yöntemini kullanın OpenExisting . OpenExisting yöntemi, mevcut adlı semaforu açmayı dener ve sistem semaforu yoksa bir özel durum oluşturur.

Windows'da, adlandırılmış semafora yalnızca geçerli kullanıcı veya tüm kullanıcılar için erişilebilir olup olmadığını belirtmek için options sağlanabilir. Ayrıca adlandırılmış semafora yalnızca geçerli oturumdaki işlemler için mi yoksa tüm oturumlar için mi erişilebilir olduğunu belirtmenize olanak tanır. Daha fazla bilgi için bkz. NamedWaitHandleOptions.

Caution

Unix tabanlı işletim sistemlerinde, options adlandırılmış semaforlar desteklenmediğinden parametresinin hiçbir etkisi yoktur.

Ayrıca bkz.

• Yönetilen İş Parçacıkları
• Semafor

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

Kaynak:

Semaphore.cs

Sınıfının yeni bir örneğini Semaphore başlatır, ilk girdi sayısını ve en fazla eşzamanlı girdi sayısını belirtir, isteğe bağlı olarak sistem semafor nesnesinin adını ve kullanıcı kapsamı ve oturum kapsamı erişimini ayarlama seçeneklerini belirtir ve yeni bir sistem semaforunun oluşturulup oluşturulmadığını belirten bir değer alan bir değişken belirtir.

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)

Parametreler

initialCount

Int32

Semafor için eşzamanlı olarak karşılanabilen ilk istek sayısı.

maximumCount

Int32

Semafor için eşzamanlı olarak karşılanabilecek en fazla istek sayısı.

name

String

Eşitleme nesnesi diğer işlemlerle paylaşılacaksa ad; null veya boş bir dize. Ad büyük/küçük harfe duyarlıdır.

options

NamedWaitHandleOptions

Adlandırılmış semafor için kapsam seçenekleri. Varsayılan erişim yalnızca geçerli kullanıcı ve geçerli oturum ile sınırlıdır. Belirtilen seçenekler, adın ad alanını ve temel alınan semafor nesnesine erişimi etkileyebilir.

createdNew

Boolean

Bu yöntem döndürdüğünde, true yerel bir semafor oluşturulup oluşturulmadığını (varsa namenull veya boş bir dize) veya belirtilen adlandırılmış sistem semaforunun oluşturulup oluşturulmadığını içerir; belirtilen adlandırılmış sistem semaforunun zaten mevcut olup olmadığını içerir false . Bu parametre başlatılmamış olarak geçirilir.

Özel durumlar

ArgumentException

initialCount değerinden maximumCountbüyüktür.

-veya-

initialCount 0'dan küçüktür.

IOException

name geçersiz. Bu, bilinmeyen ön ek veya geçersiz karakterler gibi işletim sistemi tarafından yerleştirilebilen bazı kısıtlamalar da dahil olmak üzere çeşitli nedenlerle olabilir. Adın ve "Genel\" ve "Yerel\" ortak ön eklerinin büyük/küçük harfe duyarlı olduğunu unutmayın.

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

DirectoryNotFoundException

Yalnızca Windows: name bilinmeyen bir ad alanı belirtti. Daha fazla bilgi için bkz. Nesne Adları .

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış semafor var ve erişim denetimi güvenliğine sahip ve kullanıcının yok FullControl.

WaitHandleCannotBeOpenedException

Sağlanan name ile bir eşitleme nesnesi oluşturulamıyor. Farklı türde bir eşitleme nesnesi aynı ada sahip olabilir.

-veya-

Belirtilene name sahip bir nesne var, ancak belirtilen options nesne var olan nesnenin seçenekleriyle uyumlu değil.

Açıklamalar

bir name sağlanırsa ve istenen türün eşitleme nesnesi ad alanında zaten varsa, geçerli kullanıcıyla sınırlı erişim belirtilmediği ve eşitleme nesnesinin onunla uyumlu olmadığı sürece options mevcut eşitleme nesnesi kullanılır ve bu durumda bir WaitHandleCannotBeOpenedException oluşturulur. Ad alanında farklı türde bir eşitleme nesnesi zaten varsa, bir WaitHandleCannotBeOpenedException de oluşturulur. Aksi takdirde, yeni bir eşitleme nesnesi oluşturulur.

Bu oluşturucu, adlandırılmış bir Semaphore sistem semaforu temsil eden bir nesne başlatır. Aynı adlandırılmış sistem semaforunu temsil eden birden çok Semaphore nesne oluşturabilirsiniz.

Adlandırılmış sistem semaforu yoksa, ve initialCounttarafından maximumCount belirtilen ilk sayı ve maksimum sayı ile oluşturulur. Adlandırılmış sistem semaforu zaten varsa initialCount ve maximumCount kullanılmazsa, ancak geçersiz değerler yine de özel durumlara neden olur. Sistem semaforunun createdNew bu oluşturucu tarafından oluşturulup oluşturulmadığını belirlemek için parametresini kullanın.

değerinden küçükse initialCount ve maximumCount isecreatedNew, etki geçerli iş parçacığının (true eksi WaitOne) kez çağrılmış maximumCount olmasıyla aynıdır.initialCount

için veya için boş bir dize nullbelirtirsenizname, oluşturucu aşırı yüklemesini çağırmış Semaphore(Int32, Int32) gibi yerel bir semafor oluşturulur. Bu durumda, createdNew her zaman trueolur.

Adlandırılmış semaforlar işletim sistemi genelinde görünür olduğundan, kaynak kullanımını işlem sınırları arasında koordine etmek için kullanılabilirler.

Windows'da, adlandırılmış semafora yalnızca geçerli kullanıcı veya tüm kullanıcılar için erişilebilir olup olmadığını belirtmek için options sağlanabilir. Ayrıca adlandırılmış semafora yalnızca geçerli oturumdaki işlemler için mi yoksa tüm oturumlar için mi erişilebilir olduğunu belirtmenize olanak tanır. Daha fazla bilgi için bkz. NamedWaitHandleOptions.

Caution

Unix tabanlı işletim sistemlerinde, options adlandırılmış semaforlar desteklenmediğinden parametresinin hiçbir etkisi yoktur.

Ayrıca bkz.

• Yönetilen İş Parçacıkları
• Semafor