ReaderWriterLock.AcquireWriterLock Methode

Definition

Namespace:

System.Threading

Assembly:

System.Threading.dll

Erhält die Schreibsperre.

Überlädt

AcquireWriterLock(Int32)	Erhält die Schreibsperre unter Verwendung eines Int32-Werts für das Timeout.
AcquireWriterLock(TimeSpan)	Erhält die Schreibsperre unter Verwendung eines TimeSpan-Werts für das Timeout.

AcquireWriterLock(Int32)

Quelle:

ReaderWriterLock.cs

Erhält die Schreibsperre unter Verwendung eines Int32-Werts für das Timeout.

public:
 void AcquireWriterLock(int millisecondsTimeout);

public void AcquireWriterLock (int millisecondsTimeout);

member this.AcquireWriterLock : int -> unit

Public Sub AcquireWriterLock (millisecondsTimeout As Integer)

Parameter

millisecondsTimeout

Int32

Das Timeout in Millisekunden.

Ausnahmen

ApplicationException

timeout läuft ab, bevor die Sperranforderung erteilt wird.

Beispiele

Das folgende Codebeispiel zeigt, wie eine Writersperre abgerufen und freigegeben wird und wie die Ausnahme behandelt wird, die ausgelöst wird, wenn eine Anforderung ein Zeitüberschreitung aufweist.

Dieser Code ist Teil eines größeren Beispiels, das für die ReaderWriterLock -Klasse bereitgestellt wird.

// The complete code is located in the ReaderWriterLock
// class topic.
using namespace System;
using namespace System::Threading;
public ref class Test
{
public:

   // Declaring the ReaderWriterLock at the class level
   // makes it visible to all threads.
   static ReaderWriterLock^ rwl = gcnew ReaderWriterLock;

   // For this example, the shared resource protected by the
   // ReaderWriterLock is just an integer.
   static int resource = 0;

// The complete code is located in the ReaderWriterLock class topic.
using System;
using System.Threading;

public class Example
{
   static ReaderWriterLock rwl = new ReaderWriterLock();
   // Define the shared resource protected by the ReaderWriterLock.
   static int resource = 0;

' The complete code is located in the ReaderWriterLock class topic.
Imports System.Threading

Public Module Example
   Private rwl As New ReaderWriterLock()
   ' Define the shared resource protected by the ReaderWriterLock.
   Private resource As Integer = 0

// Shows how to request and release the writer lock, and
// how to handle time-outs.
static void WriteToResource( Random^ rnd, int timeOut )
{
   try
   {
      rwl->AcquireWriterLock( timeOut );
      try
      {

         // It is safe for this thread to read or write
         // from the shared resource.
         resource = rnd->Next( 500 );
         Display( String::Format( "writes resource value {0}", resource ) );
         Interlocked::Increment( writes );
      }
      finally
      {

         // Ensure that the lock is released.
         rwl->ReleaseWriterLock();
      }

   }
   catch ( ApplicationException^ )
   {

      // The writer lock request timed out.
      Interlocked::Increment( writerTimeouts );
   }

}

// Request and release the writer lock, and handle time-outs.
static void WriteToResource(Random rnd, int timeOut)
{
   try {
      rwl.AcquireWriterLock(timeOut);
      try {
         // It's safe for this thread to access from the shared resource.
         resource = rnd.Next(500);
         Display("writes resource value " + resource);
         Interlocked.Increment(ref writes);
      }
      finally {
         // Ensure that the lock is released.
         rwl.ReleaseWriterLock();
      }
   }
   catch (ApplicationException) {
      // The writer lock request timed out.
      Interlocked.Increment(ref writerTimeouts);
   }
}

' Request and release the writer lock, and handle time-outs.
Sub WriteToResource(rnd As Random, timeOut As Integer)
   Try
      rwl.AcquireWriterLock(timeOut)
      Try
         ' It's safe for this thread to read or write from the shared resource.
         resource = rnd.Next(500)
         Display("writes resource value " & resource)
         Interlocked.Increment(writes)
      Finally
         ' Ensure that the lock is released.
         rwl.ReleaseWriterLock()
      End Try
   Catch ex As ApplicationException
      ' The writer lock request timed out.
      Interlocked.Increment(writerTimeouts)
   End Try
End Sub

};

}

End Module

Hinweise

Diese Methode blockiert, wenn ein anderer Thread über eine Leser- oder Schreibsperre verfügt. Eine Beschreibung der Art und Weise, in der die Writer-Sperre mit mehreren gleichzeitigen Lesersperren wechselt, finden Sie in der ReaderWriterLock -Klasse.

Ein Thread, der bereits über eine Lesersperre verfügt, kann die Writer-Sperre auf eine von zwei Arten abrufen: durch Loslassen der Lesersperre vor dem Aufrufen AcquireWriterLockvon oder durch Aufrufen UpgradeToWriterLockvon .

Achtung

Wenn ein Thread aufruft AcquireWriterLock , während er noch über eine Lesersperre verfügt, blockiert er seine eigene Lesersperre. Wenn ein unendliches Timeout angegeben ist, wird der Thread deadlockt. Um solche Deadlocks zu vermeiden, verwenden Sie IsReaderLockHeld , um zu bestimmen, ob der aktuelle Thread bereits über eine Lesersperre verfügt.

AcquireWriterLock unterstützt rekursive Writer-Lock-Anforderungen. Das heißt, ein Thread kann mehrmals aufrufen AcquireWriterLock , wodurch die Sperranzahl jedes Mal erhöht wird. Sie müssen einmal für jedes Mal aufrufen ReleaseWriterLock , wenn Sie aufrufen AcquireWriterLock. Alternativ können Sie aufrufen ReleaseLock , um die Sperranzahl sofort auf 0 zu reduzieren.

Rekursive Sperranforderungen werden immer sofort gewährt, ohne den anfordernden Thread in der Writer-Warteschlange zu platzieren.

Gültige Timeoutwerte finden Sie unter ReaderWriterLock.

Weitere Informationen

• Verwaltetes Threading
• ReaderWriterLock

AcquireWriterLock(TimeSpan)

Quelle:

ReaderWriterLock.cs

Erhält die Schreibsperre unter Verwendung eines TimeSpan-Werts für das Timeout.

public:
 void AcquireWriterLock(TimeSpan timeout);

public void AcquireWriterLock (TimeSpan timeout);

member this.AcquireWriterLock : TimeSpan -> unit

Public Sub AcquireWriterLock (timeout As TimeSpan)

Parameter

timeout

TimeSpan

Die TimeSpan, die den Timeoutzeitraum angibt.

Ausnahmen

ApplicationException

timeout läuft ab, bevor die Sperranforderung erteilt wird.

ArgumentOutOfRangeException

timeout gibt einen negativen Wert ungleich -1 Millisekunden an.

Hinweise

Diese Methode blockiert, wenn ein anderer Thread über eine Leser- oder Schreibsperre verfügt. Eine Beschreibung der Art und Weise, in der die Writer-Sperre mit mehreren gleichzeitigen Lesersperren wechselt, finden Sie in der ReaderWriterLock -Klasse.

Ein Thread, der bereits über eine Lesersperre verfügt, kann die Writer-Sperre auf eine von zwei Arten abrufen: durch Loslassen der Lesersperre vor dem Aufrufen AcquireWriterLockvon oder durch Aufrufen UpgradeToWriterLockvon .

Achtung

Wenn ein Thread aufruft AcquireWriterLock , während er noch über eine Lesersperre verfügt, blockiert er seine eigene Lesersperre. Wenn ein unendliches Timeout angegeben ist, wird der Thread deadlockt. Um solche Deadlocks zu vermeiden, verwenden Sie IsReaderLockHeld , um zu bestimmen, ob der aktuelle Thread bereits über eine Lesersperre verfügt.

AcquireWriterLock unterstützt rekursive Writer-Lock-Anforderungen. Das heißt, ein Thread kann mehrmals aufrufen AcquireWriterLock , wodurch die Sperranzahl jedes Mal erhöht wird. Sie müssen einmal für jedes Mal aufrufen ReleaseWriterLock , wenn Sie aufrufen AcquireWriterLock. Alternativ können Sie aufrufen ReleaseLock , um die Sperranzahl sofort auf 0 zu reduzieren.

Rekursive Sperranforderungen werden immer sofort gewährt, ohne den anfordernden Thread in der Writer-Warteschlange zu platzieren.

Gültige Timeoutwerte finden Sie unter ReaderWriterLock.

Weitere Informationen

• Verwaltetes Threading
• ReaderWriterLock