Interlocked.Increment Метод

Определение

Пространство имен:: System.Threading

Сборки:: netstandard.dll, System.Threading.dll

Сборки:: mscorlib.dll, System.Threading.dll

Сборка:: System.Threading.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.

Перегрузки

Имя	Описание
Increment(UInt32)	Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.
Increment(UInt64)	Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.
Increment(Int32)	Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.
Increment(Int64)	Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.

Increment(UInt32)

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Внимание

Этот API несовместим с CLS.

Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.

public:
 static System::UInt32 Increment(System::UInt32 % location);

[System.CLSCompliant(false)]
public static uint Increment(ref uint location);

[<System.CLSCompliant(false)>]
static member Increment : uint32 -> uint32

Public Shared Function Increment (ByRef location As UInteger) As UInteger

Параметры

location: UInt32

Переменная, значение которой необходимо увеличить.

Возвращаемое значение

UInt32

Значение переменной сразу после завершения операции увеличения.

Атрибуты: CLSCompliantAttribute

Исключения

NullReferenceException

Адрес location является указателем null .

Применяется к

Increment(UInt64)

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Исходный код:: Interlocked.cs

Внимание

Этот API несовместим с CLS.

Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.

public:
 static System::UInt64 Increment(System::UInt64 % location);

[System.CLSCompliant(false)]
public static ulong Increment(ref ulong location);

[<System.CLSCompliant(false)>]
static member Increment : uint64 -> uint64

Public Shared Function Increment (ByRef location As ULong) As ULong

Параметры

location: UInt64

Переменная, значение которой необходимо увеличить.

Возвращаемое значение

UInt64

Значение переменной сразу после завершения операции увеличения.

Атрибуты: CLSCompliantAttribute

Исключения

NullReferenceException

Адрес location является указателем null .

Применяется к

Increment(Int32)

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.

public:
 static int Increment(int % location);

public static int Increment(ref int location);

static member Increment : int -> int

Public Shared Function Increment (ByRef location As Integer) As Integer

Параметры

location: Int32

Переменная, значение которой необходимо увеличить.

Возвращаемое значение

Int32

Значение переменной сразу после завершения операции увеличения.

Исключения

NullReferenceException

Адрес location является указателем null .

Примеры

В следующем примере определяется, сколько случайных чисел, которые варьируются от 0 до 1000, необходимы для создания 1000 случайных чисел со значением середины. Для отслеживания числа средних значений переменная midpointCountимеет значение 0 и увеличивается каждый раз, когда генератор случайных чисел возвращает среднее значение, пока не достигнет 10 000. Так как три потока создают случайные числа, Increment(Int32) метод вызывается для обеспечения одновременного обновления midpointCount нескольких потоков. Обратите внимание, что блокировка также используется для защиты генератора случайных чисел, и что CountdownEvent объект используется для обеспечения того, чтобы Main метод не завершил выполнение до трех потоков.

using System;
using System.Threading;

public class Example
{
   const int LOWERBOUND = 0;
   const int UPPERBOUND = 1001;
   
   static Object lockObj = new Object();
   static Random rnd = new Random();
   static CountdownEvent cte;
   
   static int totalCount = 0;
   static int totalMidpoint = 0;
   static int midpointCount = 0;

   public static void Main()
   {
      cte = new CountdownEvent(1);
      // Start three threads. 
      for (int ctr = 0; ctr <= 2; ctr++) {
         cte.AddCount();
         Thread th = new Thread(GenerateNumbers);
         th.Name = "Thread" + ctr.ToString();
         th.Start();
      }
      cte.Signal();
      cte.Wait();
      Console.WriteLine();
      Console.WriteLine("Total midpoint values:  {0,10:N0} ({1:P3})",
                        totalMidpoint, totalMidpoint/((double)totalCount));
      Console.WriteLine("Total number of values: {0,10:N0}", 
                        totalCount);                  
   }

   private static void GenerateNumbers()
   {
      int midpoint = (UPPERBOUND - LOWERBOUND) / 2;
      int value = 0;
      int total = 0;
      int midpt = 0;
      
      do {
         lock (lockObj) {
            value = rnd.Next(LOWERBOUND, UPPERBOUND);
         }
         if (value == midpoint) { 
            Interlocked.Increment(ref midpointCount);
            midpt++;
         }
         total++;    
      } while (Volatile.Read(ref midpointCount) < 10000);
      
      Interlocked.Add(ref totalCount, total);
      Interlocked.Add(ref totalMidpoint, midpt);
      
      string s = String.Format("Thread {0}:\n", Thread.CurrentThread.Name) +
                 String.Format("   Random Numbers: {0:N0}\n", total) + 
                 String.Format("   Midpoint values: {0:N0} ({1:P3})", midpt, 
                               ((double) midpt)/total);
      Console.WriteLine(s);
      cte.Signal();
   }
}
// The example displays output like the following:
//       Thread Thread2:
//          Random Numbers: 2,776,674
//          Midpoint values: 2,773 (0.100 %)
//       Thread Thread1:
//          Random Numbers: 4,876,100
//          Midpoint values: 4,873 (0.100 %)
//       Thread Thread0:
//          Random Numbers: 2,312,310
//          Midpoint values: 2,354 (0.102 %)
//       
//       Total midpoint values:      10,000 (0.100 %)
//       Total number of values:  9,965,084

Imports System.Threading

Module Example
   Const LOWERBOUND As Integer = 0
   Const UPPERBOUND As Integer = 1001
   
   Dim lockObj As New Object()
   Dim rnd As New Random()
   Dim cte As CountdownEvent
   
   Dim totalCount As Integer = 0
   Dim totalMidpoint As Integer = 0
   Dim midpointCount As Integer = 0

   Public Sub Main()
      cte = New CountdownEvent(1)
      ' Start three threads. 
      For ctr As Integer = 0 To 2
         cte.AddCount()
         Dim th As New Thread(AddressOf GenerateNumbers)
         th.Name = "Thread" + ctr.ToString()
         th.Start()
      Next
      cte.Signal()
      cte.Wait()
      Console.WriteLine()
      Console.WriteLine("Total midpoint values:  {0,10:N0} ({1:P3})",
                        totalMidpoint, totalMidpoint/totalCount)
      Console.WriteLine("Total number of values: {0,10:N0}", 
                        totalCount)                  
   End Sub
   
   Private Sub GenerateNumbers()
      Dim midpoint As Integer = (upperBound - lowerBound) \ 2
      Dim value As Integer = 0
      Dim total As Integer = 0
      Dim midpt As Integer = 0
      Do
         SyncLock lockObj
            value = rnd.Next(lowerBound, upperBound)
         End SyncLock
         If value = midpoint Then 
            Interlocked.Increment(midpointCount)
            midpt += 1
         End If
         total += 1    
      Loop While midpointCount < 10000
      
      Interlocked.Add(totalCount, total)
      Interlocked.Add(totalMidpoint, midpt)
      
      Dim s As String = String.Format("Thread {0}:", Thread.CurrentThread.Name) + vbCrLf +
                        String.Format("   Random Numbers: {0:N0}", total) + vbCrLf +
                        String.Format("   Midpoint values: {0:N0} ({1:P3})", midpt, midpt/total)
      Console.WriteLine(s)
      cte.Signal()
   End Sub
End Module
' The example displays output like the following:
'       Thread Thread2:
'          Random Numbers: 2,776,674
'          Midpoint values: 2,773 (0.100 %)
'       Thread Thread1:
'          Random Numbers: 4,876,100
'          Midpoint values: 4,873 (0.100 %)
'       Thread Thread0:
'          Random Numbers: 2,312,310
'          Midpoint values: 2,354 (0.102 %)
'       
'       Total midpoint values:      10,000 (0.100 %)
'       Total number of values:  9,965,084

Следующий пример аналогичен предыдущему, за исключением того, что он использует Task класс вместо процедуры потока для создания 50 000 случайных средних целых чисел. В этом примере лямбда-выражение заменяет GenerateNumbers процедуру потока, а вызов Task.WaitAll метода устраняет потребность в объекте CountdownEvent .

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   const int LOWERBOUND = 0;
   const int UPPERBOUND = 1001;
   
   static Object lockObj = new Object();
   static Random rnd = new Random();
   
   static int totalCount = 0;
   static int totalMidpoint = 0;
   static int midpointCount = 0;

   public static void Main()
   {
      List<Task> tasks = new List<Task>();
      // Start three tasks. 
      for (int ctr = 0; ctr <= 2; ctr++) 
         tasks.Add(Task.Run( () => { int midpoint = (UPPERBOUND - LOWERBOUND) / 2;
                                     int value = 0;
                                     int total = 0;
                                     int midpt = 0;
                                    
                                     do {
                                        lock (lockObj) {
                                           value = rnd.Next(LOWERBOUND, UPPERBOUND);
                                        }
                                        if (value == midpoint) { 
                                           Interlocked.Increment(ref midpointCount);
                                           midpt++;
                                        }
                                        total++;    
                                     } while (Volatile.Read(ref midpointCount) < 50000);
                                    
                                     Interlocked.Add(ref totalCount, total);
                                     Interlocked.Add(ref totalMidpoint, midpt);
                                    
                                     string s = String.Format("Task {0}:\n", Task.CurrentId) +
                                                String.Format("   Random Numbers: {0:N0}\n", total) + 
                                                String.Format("   Midpoint values: {0:N0} ({1:P3})", midpt, 
                                                              ((double) midpt)/total);
                                     Console.WriteLine(s); } ));
      
      Task.WaitAll(tasks.ToArray());
      Console.WriteLine();
      Console.WriteLine("Total midpoint values:  {0,10:N0} ({1:P3})",
                        totalMidpoint, totalMidpoint/((double)totalCount));
      Console.WriteLine("Total number of values: {0,10:N0}", 
                        totalCount);                  
   }
}
// The example displays output like the following:
//       Task 3:
//          Random Numbers: 10,855,250
//          Midpoint values: 10,823 (0.100 %)
//       Task 1:
//          Random Numbers: 15,243,703
//          Midpoint values: 15,110 (0.099 %)
//       Task 2:
//          Random Numbers: 24,107,425
//          Midpoint values: 24,067 (0.100 %)
//       
//       Total midpoint values:      50,000 (0.100 %)
//       Total number of values: 50,206,378

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Const LOWERBOUND As Integer = 0
   Const UPPERBOUND As Integer = 1001
   
   Dim lockObj As New Object()
   Dim rnd As New Random()
   
   Dim totalCount As Integer = 0
   Dim totalMidpoint As Integer = 0
   Dim midpointCount As Integer = 0

   Public Sub Main()
      Dim tasks As New List(Of Task)()
      ' Start three tasks. 
      For ctr As Integer = 0 To 2
         tasks.Add(Task.Run( Sub()
                                Dim midpoint As Integer = (upperBound - lowerBound) \ 2
                                Dim value As Integer = 0
                                Dim total As Integer = 0
                                Dim midpt As Integer = 0
                                Do
                                   SyncLock lockObj
                                      value = rnd.Next(lowerBound, upperBound)
                                   End SyncLock
                                   If value = midpoint Then 
                                      Interlocked.Increment(midpointCount)
                                      midpt += 1
                                   End If
                                   total += 1    
                                Loop While midpointCount < 50000
                              
                                Interlocked.Add(totalCount, total)
                                Interlocked.Add(totalMidpoint, midpt)
                              
                                Dim s As String = String.Format("Task {0}:", Task.CurrentId) + vbCrLf +
                                                  String.Format("   Random Numbers: {0:N0}", total) + vbCrLf +
                                                  String.Format("   Midpoint values: {0:N0} ({1:P3})", midpt, midpt/total)
                                Console.WriteLine(s)
                             End Sub ))
      Next

      Task.WaitAll(tasks.ToArray())
      Console.WriteLine()
      Console.WriteLine("Total midpoint values:  {0,10:N0} ({1:P3})",
                        totalMidpoint, totalMidpoint/totalCount)
      Console.WriteLine("Total number of values: {0,10:N0}", 
                        totalCount)                  
   End Sub
End Module
' The example displays output like the following:
'       Task 3:
'          Random Numbers: 10,855,250
'          Midpoint values: 10,823 (0.100 %)
'       Task 1:
'          Random Numbers: 15,243,703
'          Midpoint values: 15,110 (0.099 %)
'       Task 2:
'          Random Numbers: 24,107,425
'          Midpoint values: 24,067 (0.100 %)
'       
'       Total midpoint values:      50,000 (0.100 %)
'       Total number of values: 50,206,378

См. также раздел

Применяется к

Increment(Int64)

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Исходный код:: Interlocked.CoreCLR.cs

Увеличивает указанную переменную и сохраняет результат в виде атомарной операции.

public:
 static long Increment(long % location);

public static long Increment(ref long location);

static member Increment : int64 -> int64

Public Shared Function Increment (ByRef location As Long) As Long

Параметры

location: Int64

Переменная, значение которой необходимо увеличить.

Возвращаемое значение

Int64

Значение переменной сразу после завершения операции увеличения.

Исключения

NullReferenceException

Адрес location является указателем null .

См. также раздел

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Interlocked.Increment Метод

Определение

Перегрузки

Increment(UInt32)

Параметры

Возвращаемое значение

Исключения

Применяется к

Increment(UInt64)

Параметры

Возвращаемое значение

Исключения

Применяется к

Increment(Int32)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Increment(Int64)

Параметры

Возвращаемое значение

Исключения

Комментарии

См. также раздел

Применяется к