ReaderWriterLockSlim.EnterUpgradeableReadLock Метод

public:
 void EnterUpgradeableReadLock();

public void EnterUpgradeableReadLock();

member this.EnterUpgradeableReadLock : unit -> unit

Public Sub EnterUpgradeableReadLock ()

Исключения

Примеры

В следующем примере показано, как использовать EnterUpgradeableReadLock метод для ввода блокировки в режиме обновления. Блок finally используется для выполнения ExitUpgradeableReadLock метода, гарантируя, что вызывающий объект выходит из режима обновления.

Метод, показанный в примере, извлекает значение, связанное с ключом, и сравнивает его с новым значением. Если значение не изменилось, метод возвращает состояние, указывающее, что изменений нет. Если для ключа не найдено значение, вставляется пара "ключ-значение". Если значение изменилось, оно обновляется. Режим обновления позволяет потоку обновлять блокировку чтения по мере необходимости без риска взаимоблокировок.

В примере используется конструктор без параметров для создания блокировки, поэтому рекурсия не допускается. ReaderWriterLockSlim Программирование проще и менее подвержено ошибкам, если блокировка не разрешает рекурсию.

Этот код является частью более крупного примера, предоставленного ReaderWriterLockSlim для класса.

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

Комментарии

Этот метод блокирует до тех пор, пока вызывающий поток не войдет в блокировку, и поэтому никогда не возвращается. TryEnterUpgradeableReadLock Используйте метод, чтобы блокировать указанный интервал, а затем возвращать, если вызывающий поток не ввел режим обновления в течение этого интервала.

Используйте режим обновления, когда поток обычно обращается к ресурсу, защищенному в режиме ReaderWriterLockSlim чтения, но может потребоваться ввести режим записи, если выполняются определенные условия. Поток в обновляемом режиме может перейти к режиму чтения или обновлению до режима записи.

Только один поток может входить в режим обновления в любое время. Если поток находится в обновляемом режиме, и нет потоков, ожидающих ввода режима записи, любое количество других потоков может входить в режим чтения, даже если потоки ожидают ввода обновляемого режима.

Если одно или несколько потоков ожидает ввода режима записи, поток, EnterUpgradeableReadLock вызывающий блоки метода, пока эти потоки не истекли или ввели режим записи, а затем вышли из него.