ReaderWriterLock.RestoreLock(LockCookie) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee herstelt u de vergrendelingsstatus van de thread naar wat deze was voordat u aanroept ReleaseLock().
public:
void RestoreLock(System::Threading::LockCookie % lockCookie);
public void RestoreLock(ref System.Threading.LockCookie lockCookie);
member this.RestoreLock : LockCookie -> unit
Public Sub RestoreLock (ByRef lockCookie As LockCookie)
Parameters
- lockCookie
- LockCookie
Een LockCookie geretourneerd door ReleaseLock().
Uitzonderingen
Het adres van lockCookie is een null-aanwijzer.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de methode gebruikt om de ReleaseLock vergrendeling vrij te geven, ongeacht hoe vaak deze is verkregen door de thread en hoe u de status van de vergrendeling later herstelt.
Deze code maakt deel uit van een groter voorbeeld voor de ReaderWriterLock klasse.
// 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
// Release all locks and later restores the lock state.
// Uses sequence numbers to determine whether another thread has
// obtained a writer lock since this thread last accessed the resource.
static void ReleaseRestore(Random rnd, int timeOut)
{
int lastWriter;
try {
rwl.AcquireReaderLock(timeOut);
try {
// It's safe for this thread to read from the shared resource,
// so read and cache the resource value.
int resourceValue = resource; // Cache the resource value.
Display("reads resource value " + resourceValue);
Interlocked.Increment(ref reads);
// Save the current writer sequence number.
lastWriter = rwl.WriterSeqNum;
// Release the lock and save a cookie so the lock can be restored later.
LockCookie lc = rwl.ReleaseLock();
// Wait for a random interval and then restore the previous state of the lock.
Thread.Sleep(rnd.Next(250));
rwl.RestoreLock(ref lc);
// Check whether other threads obtained the writer lock in the interval.
// If not, then the cached value of the resource is still valid.
if (rwl.AnyWritersSince(lastWriter)) {
resourceValue = resource;
Interlocked.Increment(ref reads);
Display("resource has changed " + resourceValue);
}
else {
Display("resource has not changed " + resourceValue);
}
}
finally {
// Ensure that the lock is released.
rwl.ReleaseReaderLock();
}
}
catch (ApplicationException) {
// The reader lock request timed out.
Interlocked.Increment(ref readerTimeouts);
}
}
' Release all locks and later restores the lock state.
' Uses sequence numbers to determine whether another thread has
' obtained a writer lock since this thread last accessed the resource.
Sub ReleaseRestore(rnd As Random ,timeOut As Integer)
Dim lastWriter As Integer
Try
rwl.AcquireReaderLock(timeOut)
Try
' It's safe for this thread to read from the shared resource,
' so read and cache the resource value.
Dim resourceValue As Integer = resource
Display("reads resource value " & resourceValue)
Interlocked.Increment(reads)
' Save the current writer sequence number.
lastWriter = rwl.WriterSeqNum
' Release the lock and save a cookie so the lock can be restored later.
Dim lc As LockCookie = rwl.ReleaseLock()
' Wait for a random interval and then restore the previous state of the lock.
Thread.Sleep(rnd.Next(250))
rwl.RestoreLock(lc)
' Check whether other threads obtained the writer lock in the interval.
' If not, then the cached value of the resource is still valid.
If rwl.AnyWritersSince(lastWriter) Then
resourceValue = resource
Interlocked.Increment(reads)
Display("resource has changed " & resourceValue)
Else
Display("resource has not changed " & resourceValue)
End If
Finally
' Ensure that the lock is released.
rwl.ReleaseReaderLock()
End Try
Catch ex As ApplicationException
' The reader lock request timed out.
Interlocked.Increment(readerTimeouts)
End Try
End Sub
}
End Module
Opmerkingen
De status hersteld door RestoreLock bevat het recursieve aantal vergrendelingen.
Een thread blokkeert als er wordt geprobeerd een lezervergrendeling te herstellen nadat een andere thread de schrijververgrendeling heeft verkregen of als deze probeert de schrijververgrendeling te herstellen nadat een andere thread een lezervergrendeling of schrijververgrendeling heeft verkregen. Omdat RestoreLock er geen time-out wordt geaccepteerd, moet u ervoor zorgen dat mogelijke impasses worden vermeden.
Caution
Voordat u belt RestoreLock, moet u ervoor zorgen dat u alle vergrendelingen hebt vrijgegeven die zijn verkregen sinds de aanroep naar ReleaseLock. Een thread loopt bijvoorbeeld vast als er een lezervergrendeling wordt verkregen en vervolgens een eerdere schrijfvergrendeling wordt hersteld. Gebruik IsReaderLockHeld en IsWriterLockHeld om dergelijke extra vergrendelingen te detecteren.
Gebruik geen LockCookie geretourneerde waarde van UpgradeToWriterLock.
Van toepassing op
Zie ook
- Het Beheerd Draadbeheer
- ReaderWriterLock