ReaderWriterLockSlim.ExitUpgradeableReadLock Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Reduz a contagem de recursão para o modo atualizável e sai do modo atualizável se a contagem resultante for 0 (zero).
public:
void ExitUpgradeableReadLock();
public void ExitUpgradeableReadLock();
member this.ExitUpgradeableReadLock : unit -> unit
Public Sub ExitUpgradeableReadLock ()
Exceções
O thread atual não inseriu o bloqueio no modo atualizável.
Exemplos
O exemplo a seguir mostra como usar um finally bloco para executar o ExitUpgradeableReadLock método, garantindo que o chamador saia do modo atualizável.
O método mostrado no exemplo recupera o valor associado a uma chave e o compara com um novo valor. Se o valor estiver inalterado, o método retornará um status que indica nenhuma alteração. Se nenhum valor for encontrado para a chave, o par chave/valor será inserido. Se o valor tiver sido alterado, ele será atualizado. O modo atualizável permite que o thread atualize o bloqueio de leitura conforme necessário, sem risco de deadlocks.
O exemplo usa o construtor sem parâmetros para criar o bloqueio, portanto, a recursão não é permitida. A programação ReaderWriterLockSlim é mais simples e menos propensa a erros quando o bloqueio não permite a recursão.
Esse código faz parte de um exemplo maior fornecido para a ReaderWriterLockSlim classe.
private ReaderWriterLockSlim cacheLock = new ReaderWriterLockSlim();
private Dictionary<int, string> innerCache = new Dictionary<int, string>();
Private cacheLock As New ReaderWriterLockSlim()
Private innerCache As New Dictionary(Of Integer, String)
public AddOrUpdateStatus AddOrUpdate(int key, string value)
{
cacheLock.EnterUpgradeableReadLock();
try
{
string result = null;
if (innerCache.TryGetValue(key, out result))
{
if (result == value)
{
return AddOrUpdateStatus.Unchanged;
}
else
{
cacheLock.EnterWriteLock();
try
{
innerCache[key] = value;
}
finally
{
cacheLock.ExitWriteLock();
}
return AddOrUpdateStatus.Updated;
}
}
else
{
cacheLock.EnterWriteLock();
try
{
innerCache.Add(key, value);
}
finally
{
cacheLock.ExitWriteLock();
}
return AddOrUpdateStatus.Added;
}
}
finally
{
cacheLock.ExitUpgradeableReadLock();
}
}
Public Function AddOrUpdate(ByVal key As Integer, _
ByVal value As String) As AddOrUpdateStatus
cacheLock.EnterUpgradeableReadLock()
Try
Dim result As String = Nothing
If innerCache.TryGetValue(key, result) Then
If result = value Then
Return AddOrUpdateStatus.Unchanged
Else
cacheLock.EnterWriteLock()
Try
innerCache.Item(key) = value
Finally
cacheLock.ExitWriteLock()
End Try
Return AddOrUpdateStatus.Updated
End If
Else
cacheLock.EnterWriteLock()
Try
innerCache.Add(key, value)
Finally
cacheLock.ExitWriteLock()
End Try
Return AddOrUpdateStatus.Added
End If
Finally
cacheLock.ExitUpgradeableReadLock()
End Try
End Function
public enum AddOrUpdateStatus
{
Added,
Updated,
Unchanged
};
Public Enum AddOrUpdateStatus
Added
Updated
Unchanged
End Enum
Comentários
Esse método não é sensível à ordem de recursão. Por exemplo, se um thread insere um bloqueio no modo atualizável e, em seguida, insere o bloqueio no modo de gravação, a ordem na qual o thread sai dos dois modos não importa. Se um bloqueio permitir a recursão, um thread poderá inserir o bloqueio no modo de gravação e inseri-lo recursivamente no modo atualizável; a ordem na qual o thread sai do modo atualizável e o modo de gravação não importa.
Sair do bloqueio pode sinalizar outros threads de espera.