ReaderWriterLock.AcquireWriterLock Metodo
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Acquisisce un blocco del writer.
AcquireWriterLock(Int32) |
Acquisisce un blocco del writer, usando un valore Int32 per il timeout. |
AcquireWriterLock(TimeSpan) |
Acquisisce un blocco del writer, usando un valore TimeSpan per il timeout. |
- Origine:
- ReaderWriterLock.cs
- Origine:
- ReaderWriterLock.cs
- Origine:
- ReaderWriterLock.cs
Acquisisce un blocco del writer, usando un valore Int32 per il timeout.
public:
void AcquireWriterLock(int millisecondsTimeout);
public void AcquireWriterLock (int millisecondsTimeout);
member this.AcquireWriterLock : int -> unit
Public Sub AcquireWriterLock (millisecondsTimeout As Integer)
Parametri
- millisecondsTimeout
- Int32
Timeout in millisecondi.
Eccezioni
L'intervallo timeout
scade prima che la richiesta di blocco sia stata soddisfatta.
Esempio
Nell'esempio di codice seguente viene illustrato come acquisire e rilasciare un blocco writer e come gestire l'eccezione generata quando si verifica il timeout di una richiesta.
Questo codice fa parte di un esempio più ampio fornito per la ReaderWriterLock classe .
// 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
Commenti
Questo metodo blocca se un altro thread ha un blocco di lettura o writer. Per una descrizione del modo in cui il blocco writer si alterna a più blocchi del lettore simultanei, vedere la ReaderWriterLock classe .
Un thread che dispone già di un blocco lettore può acquisire il blocco writer in uno dei due modi seguenti: rilasciando il blocco lettore prima di chiamare AcquireWriterLocko chiamando UpgradeToWriterLock.
Attenzione
Se un thread chiama AcquireWriterLock
mentre ha ancora un blocco lettore, verrà bloccato nel blocco del lettore. Se viene specificato un timeout infinito, il thread verrà bloccato. Per evitare questi deadlock, usare IsReaderLockHeld per determinare se il thread corrente dispone già di un blocco lettore.
AcquireWriterLock
supporta le richieste di blocco del writer ricorsivo. Ovvero, un thread può chiamare AcquireWriterLock
più volte, che incrementa il conteggio dei blocchi ogni volta. È necessario chiamare ReleaseWriterLock una volta per ogni chiamata AcquireWriterLock
a . In alternativa, è possibile chiamare ReleaseLock per ridurre immediatamente il numero di blocchi a zero.
Le richieste di blocco ricorsive vengono sempre concesse immediatamente, senza inserire il thread richiedente nella coda del writer.
Per i valori di timeout validi, vedere ReaderWriterLock.
Vedi anche
Si applica a
.NET 9 e altre versioni
Prodotto | Versioni |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Origine:
- ReaderWriterLock.cs
- Origine:
- ReaderWriterLock.cs
- Origine:
- ReaderWriterLock.cs
Acquisisce un blocco del writer, usando un valore TimeSpan per il timeout.
public:
void AcquireWriterLock(TimeSpan timeout);
public void AcquireWriterLock (TimeSpan timeout);
member this.AcquireWriterLock : TimeSpan -> unit
Public Sub AcquireWriterLock (timeout As TimeSpan)
Parametri
- timeout
- TimeSpan
Parametro TimeSpan
che specifica il periodo di timeout.
Eccezioni
L'intervallo timeout
scade prima che la richiesta di blocco sia stata soddisfatta.
Il parametro timeout
specifica un valore negativo diverso da -1 millisecondi.
Commenti
Questo metodo blocca se un altro thread ha un blocco di lettura o writer. Per una descrizione del modo in cui il blocco writer si alterna a più blocchi del lettore simultanei, vedere la ReaderWriterLock classe .
Un thread che dispone già di un blocco lettore può acquisire il blocco writer in uno dei due modi seguenti: rilasciando il blocco lettore prima di chiamare AcquireWriterLocko chiamando UpgradeToWriterLock.
Attenzione
Se un thread chiama AcquireWriterLock
mentre ha ancora un blocco lettore, verrà bloccato nel blocco del lettore. Se viene specificato un timeout infinito, il thread verrà bloccato. Per evitare questi deadlock, usare IsReaderLockHeld per determinare se il thread corrente dispone già di un blocco lettore.
AcquireWriterLock
supporta le richieste di blocco del writer ricorsivo. Ovvero, un thread può chiamare AcquireWriterLock
più volte, che incrementa il conteggio dei blocchi ogni volta. È necessario chiamare ReleaseWriterLock una volta per ogni chiamata AcquireWriterLock
a . In alternativa, è possibile chiamare ReleaseLock per ridurre immediatamente il numero di blocchi a zero.
Le richieste di blocco ricorsive vengono sempre concesse immediatamente, senza inserire il thread richiedente nella coda del writer.
Per i valori di timeout validi, vedere ReaderWriterLock.
Vedi anche
Si applica a
.NET 9 e altre versioni
Prodotto | Versioni |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: