This documentation is archived and is not being maintained.

Interlocked.Add Method (Int32, Int32)

Note: This method is new in the .NET Framework version 2.0.

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
)
public static int Add (
	/** @ref */ int location1, 
	int value
)
JScript does not support passing value-type arguments by reference.

Parameters

location1

A variable containing the first value to be added. The sum of the two values is stored in location1.

value

The value to be added to the integer at location1.

Return Value

The new value stored at location1.

Exception typeCondition

NullReferenceException

The address of location1 is a null pointer.

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.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0
Show: