Mutex Konstruktory

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Inicializuje novou instanci Mutex třídy.

Přetížení

Name	Description
Mutex()	Inicializuje novou instanci Mutex třídy s výchozími vlastnostmi.
Mutex(Boolean)	Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex.
Mutex(Boolean, String)	Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex, a řetězec, který je názvem mutex.
Mutex(String, NamedWaitHandleOptions)	Inicializuje novou instanci Mutex třídy s řetězcem, který je názvem mutex a možnostmi pro nastavení uživatelského oboru a přístupu k oboru relace. Volající vlákno nevyžaduje počáteční vlastnictví mutexu.
Mutex(Boolean, String, Boolean)	Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex, řetězec, který je název mutex a logická hodnota, která, když metoda vrátí, označuje, zda volající vlákno bylo uděleno počáteční vlastnictví mutex.
Mutex(Boolean, String, NamedWaitHandleOptions)	Inicializuje novou instanci Mutex třídy s logickou hodnotou, která indikuje, zda volající vlákno má mít počáteční vlastnictví mutex, řetězec, který je název mutex a možnosti pro nastavení přístupu k oboru uživatele a relace.
Mutex(Boolean, String, NamedWaitHandleOptions, Boolean)	Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex, řetězec, který je název mutex, možnosti nastavit uživatelský obor a relace-obor přístupu, a logickou hodnotu, která, když metoda vrátí, označuje, zda volající vlákno bylo uděleno počáteční vlastnictví mutex.

Mutex()

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s výchozími vlastnostmi.

public:
 Mutex();

public Mutex();

Public Sub New ()

Příklady

Následující příklad kódu ukazuje, jak se místní Mutex objekt používá k synchronizaci přístupu k chráněnému prostředku. Vlákno, které vytvoří mutex, ho zpočátku nevlastní.

// This example shows how a Mutex is used to synchronize access
// to a protected resource. Unlike Monitor, Mutex can be used with
// WaitHandle.WaitAll and WaitAny, and can be passed across
// AppDomain boundaries.
 
using System;
using System.Threading;

class Test13
{
    // Create a new Mutex. The creating thread does not own the
    // Mutex.
    private static Mutex mut = new Mutex();
    private const int numIterations = 1;
    private const int numThreads = 3;

    static void Main()
    {
        // Create the threads that will use the protected resource.
        for(int i = 0; i < numThreads; i++)
        {
            Thread myThread = new Thread(new ThreadStart(MyThreadProc));
            myThread.Name = String.Format("Thread{0}", i + 1);
            myThread.Start();
        }

        // The main thread exits, but the application continues to
        // run until all foreground threads have exited.
    }

    private static void MyThreadProc()
    {
        for(int i = 0; i < numIterations; i++)
        {
            UseResource();
        }
    }

    // This method represents a resource that must be synchronized
    // so that only one thread at a time can enter.
    private static void UseResource()
    {
        // Wait until it is safe to enter.
        mut.WaitOne();

        Console.WriteLine("{0} has entered the protected area", 
            Thread.CurrentThread.Name);

        // Place code to access non-reentrant resources here.

        // Simulate some work.
        Thread.Sleep(500);

        Console.WriteLine("{0} is leaving the protected area\r\n", 
            Thread.CurrentThread.Name);
         
        // Release the Mutex.
        mut.ReleaseMutex();
    }
}

' This example shows how a Mutex is used to synchronize access
' to a protected resource. Unlike Monitor, Mutex can be used with
' WaitHandle.WaitAll and WaitAny, and can be passed across
' AppDomain boundaries.
 
Imports System.Threading

Class Test
    ' Create a new Mutex. The creating thread does not own the
    ' Mutex.
    Private Shared mut As New Mutex()
    Private Const numIterations As Integer = 1
    Private Const numThreads As Integer = 3

    <MTAThread> _
    Shared Sub Main()
        ' Create the threads that will use the protected resource.
        Dim i As Integer
        For i = 1 To numThreads
            Dim myThread As New Thread(AddressOf MyThreadProc)
            myThread.Name = [String].Format("Thread{0}", i)
            myThread.Start()
        Next i

        ' The main thread exits, but the application continues to
        ' run until all foreground threads have exited.

    End Sub

    Private Shared Sub MyThreadProc()
        Dim i As Integer
        For i = 1 To numIterations
            UseResource()
        Next i
    End Sub

    ' This method represents a resource that must be synchronized
    ' so that only one thread at a time can enter.
    Private Shared Sub UseResource()
        ' Wait until it is safe to enter.
        mut.WaitOne()

        Console.WriteLine("{0} has entered protected area", _
            Thread.CurrentThread.Name)

        ' Place code to access non-reentrant resources here.

        ' Simulate some work
        Thread.Sleep(500)

        Console.WriteLine("{0} is leaving protected area" & vbCrLf, _
            Thread.CurrentThread.Name)

        ' Release Mutex.
        mut.ReleaseMutex()
    End Sub
End Class

Poznámky

Volání tohoto přetížení konstruktoru je stejné jako volání přetížení konstruktoru Mutex(Boolean) a určení false pro počáteční vlastnictví mutex. To znamená, že volající vlákno nevlastní mutex.

Viz také

• spravovaných vláken
• Mutexy

Mutex(Boolean)

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex.

public:
 Mutex(bool initiallyOwned);

public Mutex(bool initiallyOwned);

new System.Threading.Mutex : bool -> System.Threading.Mutex

Public Sub New (initiallyOwned As Boolean)

Parametry

initiallyOwned

Boolean

trueposkytnout volající vlákno počáteční vlastnictví mutex; v opačném případě . false

Příklady

Následující příklad kódu ukazuje, jak se místní Mutex objekt používá k synchronizaci přístupu k chráněnému prostředku. Vlákno, které ho zpočátku vytvoří Mutex , vlastní.

using System;
using System.Threading;

class Test
{
    private static Mutex mut;
    private const int numIterations = 1;
    private const int numThreads = 3;

    static void Main()
    {
        // Create a new Mutex. The creating thread owns the Mutex.
        mut = new Mutex(true);
        // Create the threads that will use the protected resource.
        for(int i = 0; i < numThreads; i++)
        {
            Thread myThread = new Thread(new ThreadStart(MyThreadProc));
            myThread.Name = String.Format("Thread{0}", i + 1);
            myThread.Start();
        }

        // Wait one second before allowing other threads to
        // acquire the Mutex.
        Console.WriteLine("Creating thread owns the Mutex.");
        Thread.Sleep(1000);

        Console.WriteLine("Creating thread releases the Mutex.\r\n");
        mut.ReleaseMutex();
    }

    private static void MyThreadProc()
    {
        for(int i = 0; i < numIterations; i++)
        {
            UseResource();
        }
    }

    // This method represents a resource that must be synchronized
    // so that only one thread at a time can enter.
    private static void UseResource()
    {
        // Wait until it is safe to enter.
        mut.WaitOne();

        Console.WriteLine("{0} has entered the protected area", 
            Thread.CurrentThread.Name);

        // Place code to access non-reentrant resources here.

        // Simulate some work.
        Thread.Sleep(500);

        Console.WriteLine("{0} is leaving the protected area\r\n", 
            Thread.CurrentThread.Name);
         
        // Release the Mutex.
        mut.ReleaseMutex();
    }
}
// The example displays output like the following:
//       Creating thread owns the Mutex.
//       Creating thread releases the Mutex.
//       
//       Thread1 has entered the protected area
//       Thread1 is leaving the protected area
//       
//       Thread2 has entered the protected area
//       Thread2 is leaving the protected area
//       
//       Thread3 has entered the protected area
//       Thread3 is leaving the protected area

Imports System.Threading

Class Test
    ' Create a new Mutex. The creating thread owns the
    ' Mutex.
    Private Shared mut As New Mutex(True)
    Private Const numIterations As Integer = 1
    Private Const numThreads As Integer = 3

    <MTAThread> _
    Shared Sub Main()
        ' Create the threads that will use the protected resource.
        Dim i As Integer
        For i = 1 To numThreads
            Dim myThread As New Thread(AddressOf MyThreadProc)
            myThread.Name = [String].Format("Thread{0}", i)
            myThread.Start()
        Next i

        ' Wait one second before allowing other threads to
        ' acquire the Mutex.
        Console.WriteLine("Creating thread owns the Mutex.")
        Thread.Sleep(1000)

        Console.WriteLine("Creating thread releases the Mutex." & vbCrLf)
        mut.ReleaseMutex()
    End Sub

    Private Shared Sub MyThreadProc()
        Dim i As Integer
        For i = 1 To numIterations
            UseResource()
        Next i
    End Sub

    ' This method represents a resource that must be synchronized
    ' so that only one thread at a time can enter.
    Private Shared Sub UseResource()
        ' Wait until it is safe to enter.
        mut.WaitOne()

        Console.WriteLine("{0} has entered protected area", _
            Thread.CurrentThread.Name)

        ' Place code to access non-reentrant resources here.

        ' Simulate some work
        Thread.Sleep(500)

        Console.WriteLine("{0} is leaving protected area" & vbCrLf, _
            Thread.CurrentThread.Name)

        ' Release Mutex.
        mut.ReleaseMutex()
    End Sub
End Class
' The example displays output like the following:
'       Creating thread owns the Mutex.
'       Creating thread releases the Mutex.
'       
'       Thread1 has entered the protected area
'       Thread1 is leaving the protected area
'       
'       Thread2 has entered the protected area
'       Thread2 is leaving the protected area
'       
'       Thread3 has entered the protected area
'       Thread3 is leaving the protected area

Viz také

• spravovaných vláken
• Mutexy

Mutex(Boolean, String)

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex, a řetězec, který je názvem mutex.

public:
 Mutex(bool initiallyOwned, System::String ^ name);

public Mutex(bool initiallyOwned, string? name);

new System.Threading.Mutex : bool * string -> System.Threading.Mutex

Public Sub New (initiallyOwned As Boolean, name As String)

Parametry

initiallyOwned

Boolean

trueposkytnout volající vlákno počáteční vlastnictví pojmenovaného systému mutex pokud pojmenovaný systém mutex je vytvořen v důsledku tohoto volání; v opačném případě . false

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

UnauthorizedAccessException

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

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.

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.

ArgumentException

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

Příklady

Následující příklad ukazuje, jak se pojmenovaný mutex používá k signalizaci mezi vlákny spuštěnými ve dvou samostatných procesech.

Spusťte tento program ze dvou nebo více oken příkazů. Každý proces vytvoří Mutex objekt, který představuje pojmenovaný mutex MyMutex. Pojmenovaný mutex je systémový objekt, jehož životnost je ohraničena životností Mutex objektů, které ho představují. Pojmenovaný mutex se vytvoří při prvním procesu, který vytvoří jeho Mutex objekt. V tomto příkladu je pojmenovaný mutex vlastněný prvním procesem, který program spouští. Pojmenovaný mutex je zničen, když byly uvolněny všechny Mutex objekty, které představují.

Přetížení konstruktoru použité v tomto příkladu nemůže informovat volající vlákno, zda bylo uděleno počáteční vlastnictví pojmenovaného mutex. Tento konstruktor byste neměli použít k vyžádání počátečního vlastnictví, pokud si nejste jisti, že vlákno vytvoří pojmenovaný mutex.

using System;
using System.Threading;

public class Test1
{
    public static void Main()
    {
        // Create the named mutex. Only one system object named 
        // "MyMutex" can exist; the local Mutex object represents 
        // this system object, regardless of which process or thread
        // caused "MyMutex" to be created.
        Mutex m = new Mutex(false, "MyMutex");
        
        // Try to gain control of the named mutex. If the mutex is 
        // controlled by another thread, wait for it to be released.        
        Console.WriteLine("Waiting for the Mutex.");
        m.WaitOne();

        // Keep control of the mutex until the user presses
        // ENTER.
        Console.WriteLine("This application owns the mutex. " +
            "Press ENTER to release the mutex and exit.");
        Console.ReadLine();

        m.ReleaseMutex();
    }
}

Imports System.Threading

Public Class Test
   Public Shared Sub Main()
      ' Create the named mutex. Only one system object named 
      ' "MyMutex" can exist; the local Mutex object represents 
      ' this system object, regardless of which process or thread
      ' caused "MyMutex" to be created.
      Dim m As New Mutex(False, "MyMutex")
      
      ' Try to gain control of the named mutex. If the mutex is 
      ' controlled by another thread, wait for it to be released.        
      Console.WriteLine("Waiting for the Mutex.")
      m.WaitOne()
      
      ' Keep control of the mutex until the user presses
      ' ENTER.
      Console.WriteLine("This application owns the mutex. " _
          & "Press ENTER to release the mutex and exit.")
      Console.ReadLine()
      
      m.ReleaseMutex()
   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.

Pokud name není null a initiallyOwned není true, volající vlákno vlastní mutex pouze v případě, že pojmenovaný systémový mutex byl vytvořen v důsledku tohoto volání. Vzhledem k tomu, že neexistuje žádný mechanismus pro určení, zda pojmenovaný systém mutex byl vytvořen, je lepší určit false při initiallyOwned volání tohoto přetížení konstruktoru. Konstruktor můžete použít Mutex(Boolean, String, Boolean) , pokud potřebujete určit počáteční vlastnictví.

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

Pokud již byl pojmenovaný mutex vytvořen se zabezpečením řízení přístupu a volající nemá MutexRights.FullControl, vyvolá se výjimka. Pokud chcete otevřít existující pojmenovaný mutex pouze s těmito oprávněními potřebnými pro synchronizaci aktivit vlákna, přečtěte si tuto metodu OpenExisting .

Pokud zadáte null nebo prázdný řetězec pro name, vytvoří se místní mutex, jako byste volali Mutex(Boolean) konstruktor.

Vzhledem k tomu, že se jedná o systémové, pojmenované mutexy lze použít ke koordinaci využití prostředků napříč hranicemi procesu.

Note

Na serveru se spuštěnou terminálovou službou může pojmenovaný systémový mutex mít dvě úrovně viditelnosti. Pokud název začíná předponou Global\, je mutex viditelný ve všech relacích terminálového serveru. Pokud jeho název začíná předponou Local\, je mutex viditelný pouze v relaci terminálového serveru, kde byla vytvořena. V takovém případě může existovat samostatný mutex se stejným názvem v každé druhé relaci terminálového serveru na serveru. Pokud při vytváření pojmenovaného mutex nezadáte předponu, převezme předponu Local\. V rámci relace terminálového serveru jsou dva mutexy, jejichž názvy se liší pouze podle jejich předpon, samostatné mutexy a oba jsou viditelné pro všechny procesy v relaci terminálového serveru. To znamená, že názvy Global\ předpon a Local\ popisují rozsah názvu mutex vzhledem k relacím terminálového serveru, nikoli vzhledem k procesům.

Caution

Ve výchozím nastavení není pojmenovaný mutex omezen na uživatele, který ho vytvořil. Ostatní uživatelé mohou být schopni otevřít a používat mutex, včetně zasahování do mutexu zadáním mutexu a jeho ukončením. V operačníchsystémechch Windows Pokud chcete omezit přístup konkrétním uživatelům, můžete při vytváření pojmenovaného mutex použít přetížení konstruktoru nebo MutexAcl a předat MutexSecurity. V operačních systémech unixových systémů v současné době neexistuje způsob, jak omezit přístup k pojmenované mutex. Vyhněte se používání pojmenovaných mutexů bez omezení přístupu v systémech, které můžou mít nedůvěryhodné uživatele se spuštěným kódem.

Zpětné lomítko (\) je vyhrazený znak v názvu mutex. Nepoužívejte zpětné lomítko (\) v názvu mutex s výjimkou toho, jak je uvedeno v poznámce při použití mutexů v relacích terminálového serveru. DirectoryNotFoundException Jinak může dojít k vyvolání, i když název mutex představuje existující soubor.

Viz také

• spravovaných vláken
• Mutexy

Mutex(String, NamedWaitHandleOptions)

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s řetězcem, který je názvem mutex a možnostmi pro nastavení uživatelského oboru a přístupu k oboru relace. Volající vlákno nevyžaduje počáteční vlastnictví mutexu.

public:
 Mutex(System::String ^ name, System::Threading::NamedWaitHandleOptions options);

public Mutex(string? name, System.Threading.NamedWaitHandleOptions options);

new System.Threading.Mutex : string * System.Threading.NamedWaitHandleOptions -> System.Threading.Mutex

Public Sub New (name As String, options As NamedWaitHandleOptions)

Parametry

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 systémového mutexu. Ve výchozím nastavení je přístup omezený pouze na aktuálního uživatele a aktuální relaci. Zadané možnosti můžou mít vliv na obor názvů pro název a přístup k podkladovému systémovému objektu mutex.

Výjimky

UnauthorizedAccessException

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

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.

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 však určuje přístup omezený na aktuálního uživatele a synchronizační objekt není s ním kompatibilní, WaitHandleCannotBeOpenedException vyvolá se. 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 Mutex objekt, který představuje pojmenovaný systémový mutex. Můžete vytvořit více Mutex objektů, které představují stejný pojmenovaný systémový mutex.

Pokud již byl pojmenovaný mutex vytvořen se zabezpečením řízení přístupu a volající nemá MutexRights.FullControl, vyvolá se výjimka. Pokud chcete otevřít existující pojmenovaný mutex pouze s těmito oprávněními potřebnými pro synchronizaci aktivit vlákna, přečtěte si tuto metodu OpenExisting .

Pokud zadáte null nebo prázdný řetězec pro name, vytvoří se místní mutex, jako byste volali Mutex(Boolean) konstruktor.

Vzhledem k tomu, že se jedná o systémové, pojmenované mutexy lze použít ke koordinaci využití prostředků napříč hranicemi procesu.

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

Zpětné lomítko (\) je vyhrazený znak v názvu mutex. Nepoužívejte zpětné lomítko (\) v názvu mutex s výjimkou toho, jak je uvedeno v poznámce při použití mutexů v relacích terminálového serveru. DirectoryNotFoundException Jinak může dojít k vyvolání, i když název mutex představuje existující soubor.

Viz také

• spravovaných vláken
• Mutexy

Mutex(Boolean, String, Boolean)

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex, řetězec, který je název mutex a logická hodnota, která, když metoda vrátí, označuje, zda volající vlákno bylo uděleno počáteční vlastnictví mutex.

public:
 Mutex(bool initiallyOwned, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew);

public Mutex(bool initiallyOwned, string? name, out bool createdNew);

new System.Threading.Mutex : bool * string * bool -> System.Threading.Mutex

Public Sub New (initiallyOwned As Boolean, name As String, ByRef createdNew As Boolean)

Parametry

initiallyOwned

Boolean

trueposkytnout volající vlákno počáteční vlastnictví pojmenovaného systému mutex pokud pojmenovaný systém mutex je vytvořen v důsledku tohoto volání; v opačném případě . false

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 logickou hodnotu, která je true v případě, že byl vytvořen místní mutex (tj. pokud name je null nebo prázdný řetězec) nebo pokud zadaný pojmenovaný systémový mutex byl vytvořen; false pokud zadaný pojmenovaný systémový mutex již existoval. Tento parametr se předává neinicializovaný.

Výjimky

UnauthorizedAccessException

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

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.

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.

ArgumentException

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

Příklady

Následující příklad kódu ukazuje, jak se pojmenovaný mutex používá k signalizaci mezi procesy nebo vlákny. Spusťte tento program ze dvou nebo více oken příkazů. Každý proces vytvoří Mutex objekt, který představuje pojmenovaný mutex "MyMutex". Pojmenovaný mutex je systémový objekt. V tomto příkladu je jeho životnost ohraničena životností Mutex objektů, které ho představují. Pojmenovaný mutex se vytvoří, když první proces vytvoří jeho místní Mutex objekt, a zničen, když byly vydány všechny Mutex objekty, které představují. Pojmenovaný mutex je původně vlastněný prvním procesem. Druhý proces a všechny následné procesy čekají, až dřívější procesy uvolní pojmenovaný mutex.

// This example shows how a named mutex is used to signal between
// processes or threads.
// Run this program from two (or more) command windows. Each process
// creates a Mutex object that represents the named mutex "MyMutex".
// The named mutex is a system object whose lifetime is bounded by the
// lifetimes of the Mutex objects that represent it. The named mutex
// is created when the first process creates its local Mutex; in this
// example, the named mutex is owned by the first process. The named 
// mutex is destroyed when all the Mutex objects that represent it
// have been released. 
// The second process (and any subsequent process) waits for earlier
// processes to release the named mutex.

using System;
using System.Threading;

public class Test12
{
    public static void Main()
    {
        // Set this variable to false if you do not want to request 
        // initial ownership of the named mutex.
        bool requestInitialOwnership = true;
        bool mutexWasCreated;

        // Request initial ownership of the named mutex by passing
        // true for the first parameter. Only one system object named 
        // "MyMutex" can exist; the local Mutex object represents 
        // this system object. If "MyMutex" is created by this call,
        // then mutexWasCreated contains true; otherwise, it contains
        // false.
        Mutex m = new Mutex(requestInitialOwnership, 
                            "MyMutex", 
                            out mutexWasCreated);
        
        // This thread owns the mutex only if it both requested 
        // initial ownership and created the named mutex. Otherwise,
        // it can request the named mutex by calling WaitOne.
        if (!(requestInitialOwnership && mutexWasCreated))
        {
            Console.WriteLine("Waiting for the named mutex.");
            m.WaitOne();
        }

        // Once the process has gained control of the named mutex,
        // hold onto it until the user presses ENTER.
        Console.WriteLine("This process owns the named mutex. " +
            "Press ENTER to release the mutex and exit.");
        Console.ReadLine();

        // Call ReleaseMutex to allow other threads to gain control
        // of the named mutex. If you keep a reference to the local
        // Mutex, you can call WaitOne to request control of the 
        // named mutex.
        m.ReleaseMutex();
    }
}

' This example shows how a named mutex is used to signal between
' processes or threads.
' Run this program from two (or more) command windows. Each process
' creates a Mutex object that represents the named mutex "MyMutex".
' The named mutex is a system object whose lifetime is bounded by the
' lifetimes of the Mutex objects that represent it. The named mutex
' is created when the first process creates its local Mutex; in this
' example, the named mutex is owned by the first process. The named 
' mutex is destroyed when all the Mutex objects that represent it
' have been released. 
' The second process (and any subsequent process) waits for earlier
' processes to release the named mutex.

Imports System.Threading

Public Class Test
   
   <MTAThread> _
   Public Shared Sub Main()
      ' Set this variable to false if you do not want to request 
      ' initial ownership of the named mutex.
      Dim requestInitialOwnership As Boolean = True
      Dim mutexWasCreated As Boolean
      
      ' Request initial ownership of the named mutex by passing
      ' true for the first parameter. Only one system object named 
      ' "MyMutex" can exist; the local Mutex object represents 
      ' this system object. If "MyMutex" is created by this call,
      ' then mutexWasCreated contains true; otherwise, it contains
      ' false.
      Dim m As New Mutex(requestInitialOwnership, "MyMutex", _
          mutexWasCreated)
      
      ' This thread owns the mutex only if it both requested 
      ' initial ownership and created the named mutex. Otherwise,
      ' it can request the named mutex by calling WaitOne.
      If Not (requestInitialOwnership And mutexWasCreated) Then
         Console.WriteLine("Waiting for the named mutex.")
         m.WaitOne()
      End If
      
      ' Once the process has gained control of the named mutex,
      ' hold onto it until the user presses ENTER.
      Console.WriteLine("This process owns the named mutex. " _
          & "Press ENTER to release the mutex and exit.")
      Console.ReadLine()
      
      ' Call ReleaseMutex to allow other threads to gain control
      ' of the named mutex. If you keep a reference to the local
      ' Mutex, you can call WaitOne to request control of the 
      ' named mutex.
      m.ReleaseMutex()
   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.

Pokud name není null a initiallyOwned je true, volající vlákno vlastní pojmenovaný mutex pouze v případě, že createdNew je true po volání. Jinak vlákno může požádat mutex voláním WaitOne metody.

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

Pokud již byl pojmenovaný mutex vytvořen se zabezpečením řízení přístupu a volající nemá MutexRights.FullControl práva, vyvolá se výjimka. Pokud chcete otevřít existující pojmenovaný mutex pouze s těmito oprávněními potřebnými pro synchronizaci aktivit vlákna, přečtěte si tuto metodu OpenExisting .

Pokud zadáte null nebo prázdný řetězec pro name, vytvoří se místní mutex, jako byste volali Mutex(Boolean) konstruktor. V tomto případě je createdNew vždy true.

Vzhledem k tomu, že se jedná o systémové, pojmenované mutexy lze použít ke koordinaci využití prostředků napříč hranicemi procesu.

Note

Na serveru se spuštěnou terminálovou službou může pojmenovaný systémový mutex mít dvě úrovně viditelnosti. Pokud název začíná předponou Global\, je mutex viditelný ve všech relacích terminálového serveru. Pokud jeho název začíná předponou Local\, je mutex viditelný pouze v relaci terminálového serveru, kde byla vytvořena. V takovém případě může existovat samostatný mutex se stejným názvem v každé druhé relaci terminálového serveru na serveru. Pokud při vytváření pojmenovaného mutex nezadáte předponu, převezme předponu Local\. V rámci relace terminálového serveru jsou dva mutexy, jejichž názvy se liší pouze podle jejich předpon, samostatné mutexy a oba jsou viditelné pro všechny procesy v relaci terminálového serveru. To znamená, že názvy Global\ předpon a Local\ popisují rozsah názvu mutex vzhledem k relacím terminálového serveru, nikoli vzhledem k procesům.

Caution

Ve výchozím nastavení není pojmenovaný mutex omezen na uživatele, který ho vytvořil. Ostatní uživatelé mohou být schopni otevřít a používat mutex, včetně zasahování do mutexu zadáním mutexu a jeho ukončením. V operačníchsystémechch Windows Pokud chcete omezit přístup konkrétním uživatelům, můžete při vytváření pojmenovaného mutex použít přetížení konstruktoru nebo MutexAcl a předat MutexSecurity. V operačních systémech unixových systémů v současné době neexistuje způsob, jak omezit přístup k pojmenované mutex. Vyhněte se používání pojmenovaných mutexů bez omezení přístupu v systémech, které můžou mít nedůvěryhodné uživatele se spuštěným kódem.

Zpětné lomítko (\) je vyhrazený znak v názvu mutex. Nepoužívejte zpětné lomítko (\) v názvu mutex s výjimkou toho, jak je uvedeno v poznámce při použití mutexů v relacích terminálového serveru. DirectoryNotFoundException Jinak může dojít k vyvolání, i když název mutex představuje existující soubor.

Viz také

• spravovaných vláken
• Mutexy

Mutex(Boolean, String, NamedWaitHandleOptions)

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s logickou hodnotou, která indikuje, zda volající vlákno má mít počáteční vlastnictví mutex, řetězec, který je název mutex a možnosti pro nastavení přístupu k oboru uživatele a relace.

public:
 Mutex(bool initiallyOwned, System::String ^ name, System::Threading::NamedWaitHandleOptions options);

public Mutex(bool initiallyOwned, string? name, System.Threading.NamedWaitHandleOptions options);

new System.Threading.Mutex : bool * string * System.Threading.NamedWaitHandleOptions -> System.Threading.Mutex

Public Sub New (initiallyOwned As Boolean, name As String, options As NamedWaitHandleOptions)

Parametry

initiallyOwned

Boolean

trueposkytnout volající vlákno počáteční vlastnictví pojmenovaného systému mutex pokud pojmenovaný systém mutex je vytvořen v důsledku tohoto volání; v opačném případě . false

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 systémového mutexu. Ve výchozím nastavení je přístup omezený pouze na aktuálního uživatele a aktuální relaci. Zadané možnosti můžou mít vliv na obor názvů pro název a přístup k podkladovému systémovému objektu mutex.

Výjimky

UnauthorizedAccessException

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

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.

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 však určuje přístup omezený na aktuálního uživatele a synchronizační objekt není s ním kompatibilní, WaitHandleCannotBeOpenedException vyvolá se. 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 name není null a initiallyOwned není true, volající vlákno vlastní mutex pouze v případě, že pojmenovaný systémový mutex byl vytvořen v důsledku tohoto volání. Vzhledem k tomu, že neexistuje žádný mechanismus pro určení, zda pojmenovaný systém mutex byl vytvořen, je lepší určit false při initiallyOwned volání tohoto přetížení konstruktoru. Konstruktor můžete použít Mutex(Boolean, String, Boolean) , pokud potřebujete určit počáteční vlastnictví.

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

Pokud již byl pojmenovaný mutex vytvořen se zabezpečením řízení přístupu a volající nemá MutexRights.FullControl, vyvolá se výjimka. Pokud chcete otevřít existující pojmenovaný mutex pouze s těmito oprávněními potřebnými pro synchronizaci aktivit vlákna, přečtěte si tuto metodu OpenExisting .

Pokud zadáte null nebo prázdný řetězec pro name, vytvoří se místní mutex, jako byste volali Mutex(Boolean) konstruktor.

Vzhledem k tomu, že se jedná o systémové, pojmenované mutexy lze použít ke koordinaci využití prostředků napříč hranicemi procesu.

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

Viz také

• spravovaných vláken
• Mutexy

Mutex(Boolean, String, NamedWaitHandleOptions, Boolean)

Zdroj:

Mutex.cs

Inicializuje novou instanci Mutex třídy s logickou hodnotou, která označuje, zda volající vlákno by mělo mít počáteční vlastnictví mutex, řetězec, který je název mutex, možnosti nastavit uživatelský obor a relace-obor přístupu, a logickou hodnotu, která, když metoda vrátí, označuje, zda volající vlákno bylo uděleno počáteční vlastnictví mutex.

public:
 Mutex(bool initiallyOwned, System::String ^ name, System::Threading::NamedWaitHandleOptions options, [Runtime::InteropServices::Out] bool % createdNew);

public Mutex(bool initiallyOwned, string? name, System.Threading.NamedWaitHandleOptions options, out bool createdNew);

new System.Threading.Mutex : bool * string * System.Threading.NamedWaitHandleOptions * bool -> System.Threading.Mutex

Public Sub New (initiallyOwned As Boolean, name As String, options As NamedWaitHandleOptions, ByRef createdNew As Boolean)

Parametry

initiallyOwned

Boolean

trueposkytnout volající vlákno počáteční vlastnictví pojmenovaného systému mutex pokud pojmenovaný systém mutex je vytvořen v důsledku tohoto volání; v opačném případě . false

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 systémového mutexu. Ve výchozím nastavení je přístup omezený pouze na aktuálního uživatele a aktuální relaci. Zadané možnosti můžou mít vliv na obor názvů pro název a přístup k podkladovému systémovému objektu mutex.

createdNew

Boolean

Pokud tato metoda vrátí, obsahuje logickou hodnotu, která je true v případě, že byl vytvořen místní mutex (tj. pokud name je null nebo prázdný řetězec) nebo pokud zadaný pojmenovaný systémový mutex byl vytvořen; obsahuje false , pokud zadaný pojmenovaný systémový mutex již existoval. Tento parametr se předává neinicializovaný.

Výjimky

UnauthorizedAccessException

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

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.

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 však určuje přístup omezený na aktuálního uživatele a synchronizační objekt není s ním kompatibilní, WaitHandleCannotBeOpenedException vyvolá se. 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 name není null a initiallyOwned je true, volající vlákno vlastní pojmenovaný mutex pouze v případě, že createdNew je true po volání. Jinak vlákno může požádat mutex voláním WaitOne metody.

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

Pokud již byl pojmenovaný mutex vytvořen se zabezpečením řízení přístupu a volající nemá MutexRights.FullControl práva, vyvolá se výjimka. Pokud chcete otevřít existující pojmenovaný mutex pouze s těmito oprávněními potřebnými pro synchronizaci aktivit vlákna, přečtěte si tuto metodu OpenExisting .

Pokud zadáte null nebo prázdný řetězec pro name, vytvoří se místní mutex, jako byste volali Mutex(Boolean) konstruktor. V tomto případě je createdNew vždy true.

Vzhledem k tomu, že se jedná o systémové, pojmenované mutexy lze použít ke koordinaci využití prostředků napříč hranicemi procesu.

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

Viz také

• spravovaných vláken
• Mutexy