Interlocked.Add 方法

定義

命名空間:

System.Threading

組件:

netstandard.dll, System.Threading.dll

將兩個整數相加，並將第一個整數替換為和，作為原子運算。

多載

名稱	Description
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 位址是空指標。

備註

此方法處理溢位條件時，會繞行：若 在 的location1值為 Int32.MaxValuevalue 且為 1，則結果為 Int32.MinValue;若value為 2，則結果為 （Int32.MinValue+1）;依此類推。 沒例外拋出。

另請參閱

• 管理的執行緒
• 同步處理基本概觀

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 位址是空指標。

備註

此方法處理溢位條件時，會繞行：若 在 的location1值為 Int64.MaxValuevalue 且為 1，則結果為 Int64.MinValue;若value為 2，則結果為 （Int64.MinValue+1）;依此類推。 沒例外拋出。

另請參閱

• Increment
• Decrement
• Read(Int64)
• 管理的執行緒
• 同步處理基本概觀

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 指標。