0 out of 1 rated this helpful - Rate this topic

Interlocked.Add Method (Int32, Int32)

.NET Framework 4.5

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)

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

Parameters

location1: Type: System.Int32
A variable containing 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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Interlocked Class

Add Overload

System.Threading Namespace

Other Resources

Managed Threading

Interlocked Operations

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)