Interlocked.Add 方法

定義

命名空間:

System.Threading

組件:

System.Threading.dll

將兩個整數相加，並以總和取代第一個整數，成為不可部分完成的作業。

多載

Add(Int32, Int32)	將兩個 32 位元整數加相，並以總和取代第一個整數，成為不可部分完成的作業。
Add(Int64, Int64)	將兩個 64 位元整數加相，並以總和取代第一個整數，成為不可部分完成的作業。
Add(UInt32, UInt32)	將兩個 32 位元不帶正負號的整數相加，並以總和取代第一個整數，成為不可部分完成的作業。
Add(UInt64, UInt64)	將兩個 64 位元不帶正負號的整數相加，並以總和取代第一個整數，成為不可部分完成的作業。

Add(Int32, Int32)

來源:

Interlocked.CoreCLR.cs

將兩個 32 位元整數加相，並以總和取代第一個整數，成為不可部分完成的作業。

public:
 static int Add(int % location1, int value);

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

static member Add : int * int -> int

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

參數

location1

Int32

包含要加入的第一個值的變數。 這兩個值的總和會存放在 location1 中。

value

Int32

要加入 location1 的整數的值。

傳回

Int32

這項作業儲存在 location1 的新值。

例外狀況

NullReferenceException

location1 的位址為 null 指標。

備註

這個方法會包裝處理溢位條件：如果 的 location1Int32.MaxValue 值為 且 value 為 1，則結果為 Int32.MinValue ;如果 value 為 2，則結果會 (Int32.MinValue + 1) ，依此類錯。 不會擲回任何例外狀況。

另請參閱

• Managed 執行緒處理
• 同步處理原始物件概觀

Add(Int64, Int64)

來源:

Interlocked.CoreCLR.cs

將兩個 64 位元整數加相，並以總和取代第一個整數，成為不可部分完成的作業。

public:
 static long Add(long % location1, long value);

public static long Add (ref long location1, long value);

static member Add : int64 * int64 -> int64

Public Shared Function Add (ByRef location1 As Long, value As Long) As Long

參數

location1

Int64

包含要加入的第一個值的變數。 這兩個值的總和會存放在 location1 中。

value

Int64

要加入 location1 的整數的值。

傳回

Int64

這項作業儲存在 location1 的新值。

例外狀況

NullReferenceException

location1 的位址為 null 指標。

備註

這個方法會包裝處理溢位條件：如果 的 location1Int64.MaxValue 值為 且 value 為 1，則結果為 Int64.MinValue ;如果 value 為 2，則結果會 (Int64.MinValue + 1) ，依此類錯。 不會擲回任何例外狀況。

另請參閱

• Increment
• Decrement
• Read(Int64)
• Managed 執行緒處理
• 同步處理原始物件概觀

Add(UInt32, UInt32)

來源:

Interlocked.cs

重要

此 API 不符合 CLS 規範。

將兩個 32 位元不帶正負號的整數相加，並以總和取代第一個整數，成為不可部分完成的作業。

public:
 static System::UInt32 Add(System::UInt32 % location1, System::UInt32 value);

[System.CLSCompliant(false)]
public static uint Add (ref uint location1, uint value);

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

Public Shared Function Add (ByRef location1 As UInteger, value As UInteger) As UInteger

參數

location1

UInt32

包含要加入的第一個值的變數。 這兩個值的總和會存放在 location1 中。

value

UInt32

要加入 location1 的整數的值。

傳回

UInt32

這項作業儲存在 location1 的新值。

屬性

CLSCompliantAttribute

例外狀況

NullReferenceException

location1 的位址為 null 指標。

Add(UInt64, UInt64)

來源:

Interlocked.cs

重要

此 API 不符合 CLS 規範。

將兩個 64 位元不帶正負號的整數相加，並以總和取代第一個整數，成為不可部分完成的作業。

public:
 static System::UInt64 Add(System::UInt64 % location1, System::UInt64 value);

[System.CLSCompliant(false)]
public static ulong Add (ref ulong location1, ulong value);

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

Public Shared Function Add (ByRef location1 As ULong, value As ULong) As ULong

參數

location1

UInt64

包含要加入的第一個值的變數。 這兩個值的總和會存放在 location1 中。

value

UInt64

要加入 location1 的整數的值。

傳回

UInt64

這項作業儲存在 location1 的新值。

屬性

CLSCompliantAttribute

例外狀況

NullReferenceException

location1 的位址為 null 指標。