• Article

Interlocked.Add Method (Int32%, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Adds two 32-bit integers and replaces the first integer with the sum, as an atomic operation.

Namespace:  System.Threading
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function Add ( _
    ByRef location1 As Integer, _
    value As Integer _
) As Integer

public static int Add(
    ref int location1,
    int value
)

Parameters

  • location1
    Type: System.Int32%
    A variable that contains the first value to be added. The sum of the two values is stored in location1.
  • value
    Type: System.Int32
    The value to be added to the integer at location1.

Return Value

Type: System.Int32
The new value stored at location1.

Exceptions

Exception Condition
NullReferenceException

The address of location1 is a null pointer.

Remarks

This method handles an overflow condition by wrapping: If the value at location1 is Int32.MaxValue and value is 1, the result is Int32.MinValue; if value is 2, the result is (Int32.MinValue + 1); and so on. No exception is thrown.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.