ReaderWriterLock.AcquireWriterLock 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.
Adquire o bloqueio do gravador.
Sobrecargas
| Nome | Description |
|---|---|
| AcquireWriterLock(Int32) |
Adquire o bloqueio de gravador usando um Int32 valor para o tempo limite. |
| AcquireWriterLock(TimeSpan) |
Adquire o bloqueio de gravador usando um TimeSpan valor para o tempo limite. |
AcquireWriterLock(Int32)
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
Adquire o bloqueio de gravador usando um Int32 valor para o tempo limite.
public:
void AcquireWriterLock(int millisecondsTimeout);
public void AcquireWriterLock(int millisecondsTimeout);
member this.AcquireWriterLock : int -> unit
Public Sub AcquireWriterLock (millisecondsTimeout As Integer)
Parâmetros
- millisecondsTimeout
- Int32
O tempo limite em milissegundos.
Exceções
millisecondsTimeout expira antes que a solicitação de bloqueio seja concedida.
Exemplos
O exemplo de código a seguir mostra como adquirir e liberar um bloqueio de gravador e como lidar com a exceção gerada quando uma solicitação atinge o tempo limite.
Esse código faz parte de um exemplo maior fornecido para a ReaderWriterLock classe.
// 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
// 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
Comentários
Esse método bloqueia se outro thread tiver um bloqueio de leitor ou bloqueio de gravador. Para obter uma descrição da maneira como o bloqueio do gravador alterna com vários bloqueios de leitor simultâneos, consulte a ReaderWriterLock classe.
Um thread que já tem um bloqueio de leitor pode adquirir o bloqueio do gravador de duas maneiras: liberando o bloqueio do leitor antes de chamar AcquireWriterLockou chamando UpgradeToWriterLock.
Caution
Se um thread chamar AcquireWriterLock enquanto ainda tiver um bloqueio de leitor, ele bloqueará em seu próprio bloqueio de leitor; se um tempo limite infinito for especificado, o thread será bloqueado. Para evitar tais deadlocks, use IsReaderLockHeld para determinar se o thread atual já tem um bloqueio de leitor.
AcquireWriterLock dá suporte a solicitações recursivas de bloqueio de gravador. Ou seja, um thread pode chamar AcquireWriterLock várias vezes, o que incrementa a contagem de bloqueios a cada vez. Você deve ligar ReleaseWriterLock uma vez para cada vez que ligar AcquireWriterLock. Como alternativa, você pode chamar ReleaseLock para reduzir a contagem de bloqueios para zero imediatamente.
Solicitações de bloqueio recursivo são sempre concedidas imediatamente, sem colocar o thread de solicitação na fila do gravador.
Para obter valores de tempo limite válidos, consulte ReaderWriterLock.
Confira também
Aplica-se a
AcquireWriterLock(TimeSpan)
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
- Origem:
- ReaderWriterLock.cs
Adquire o bloqueio de gravador usando um TimeSpan valor para o tempo limite.
public:
void AcquireWriterLock(TimeSpan timeout);
public void AcquireWriterLock(TimeSpan timeout);
member this.AcquireWriterLock : TimeSpan -> unit
Public Sub AcquireWriterLock (timeout As TimeSpan)
Parâmetros
- timeout
- TimeSpan
A TimeSpan especificação do período de tempo limite.
Exceções
timeout expira antes que a solicitação de bloqueio seja concedida.
timeout especifica um valor negativo diferente de -1 milissegundos.
Comentários
Esse método bloqueia se outro thread tiver um bloqueio de leitor ou bloqueio de gravador. Para obter uma descrição da maneira como o bloqueio do gravador alterna com vários bloqueios de leitor simultâneos, consulte a ReaderWriterLock classe.
Um thread que já tem um bloqueio de leitor pode adquirir o bloqueio do gravador de duas maneiras: liberando o bloqueio do leitor antes de chamar AcquireWriterLockou chamando UpgradeToWriterLock.
Caution
Se um thread chamar AcquireWriterLock enquanto ainda tiver um bloqueio de leitor, ele bloqueará em seu próprio bloqueio de leitor; se um tempo limite infinito for especificado, o thread será bloqueado. Para evitar tais deadlocks, use IsReaderLockHeld para determinar se o thread atual já tem um bloqueio de leitor.
AcquireWriterLock dá suporte a solicitações recursivas de bloqueio de gravador. Ou seja, um thread pode chamar AcquireWriterLock várias vezes, o que incrementa a contagem de bloqueios a cada vez. Você deve ligar ReleaseWriterLock uma vez para cada vez que ligar AcquireWriterLock. Como alternativa, você pode chamar ReleaseLock para reduzir a contagem de bloqueios para zero imediatamente.
Solicitações de bloqueio recursivo são sempre concedidas imediatamente, sem colocar o thread de solicitação na fila do gravador.
Para obter valores de tempo limite válidos, consulte ReaderWriterLock.