Interlocked.Add Método

Definição

Namespace:

System.Threading

Assembly:

System.Threading.dll

Adiciona dois números inteiros e substitui o primeiro inteiro com a soma, como uma operação atômica.

Sobrecargas

Add(Int32, Int32)	Adiciona dois números inteiros de 32 bits e substitui o primeiro inteiro com a soma, como uma operação atômica.
Add(Int64, Int64)	Adiciona dois números inteiros de 64 bits e substitui o primeiro inteiro com a soma, como uma operação atômica.
Add(UInt32, UInt32)	Adiciona dois números inteiros sem sinal de 32 bits e substitui o primeiro inteiro pela soma, como uma operação atômica.
Add(UInt64, UInt64)	Adiciona dois números inteiros sem sinal de 64 bits e substitui o primeiro inteiro pela soma, como uma operação atômica.

Add(Int32, Int32)

Origem:

Interlocked.CoreCLR.cs

Adiciona dois números inteiros de 32 bits e substitui o primeiro inteiro com a soma, como uma operação atômica.

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

Parâmetros

location1

Int32

Uma variável que contém o primeiro valor a ser adicionado. A soma dos dois valores é armazenada em location1.

value

Int32

O valor a ser adicionado ao inteiro em location1.

Retornos

Int32

O novo valor que foi armazenado em location1 por essa operação.

Exceções

NullReferenceException

O endereço de location1 é um ponteiro nulo.

Comentários

Esse método manipula uma condição de estouro encapsulando: se o valor em location1 for Int32.MaxValue e value for 1, o resultado será Int32.MinValue; se value for 2, o resultado será (Int32.MinValue + 1); e assim por diante. Nenhuma exceção é gerada.

Confira também

• Threading gerenciado
• Visão geral dos primitivos de sincronização

Add(Int64, Int64)

Origem:

Interlocked.CoreCLR.cs

Adiciona dois números inteiros de 64 bits e substitui o primeiro inteiro com a soma, como uma operação atômica.

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

Parâmetros

location1

Int64

Uma variável que contém o primeiro valor a ser adicionado. A soma dos dois valores é armazenada em location1.

value

Int64

O valor a ser adicionado ao inteiro em location1.

Retornos

Int64

O novo valor que foi armazenado em location1 por essa operação.

Exceções

NullReferenceException

O endereço de location1 é um ponteiro nulo.

Comentários

Esse método manipula uma condição de estouro encapsulando: se o valor em location1 for Int64.MaxValue e value for 1, o resultado será Int64.MinValue; se value for 2, o resultado será (Int64.MinValue + 1); e assim por diante. Nenhuma exceção é gerada.

Confira também

• Increment
• Decrement
• Read(Int64)
• Threading gerenciado
• Visão geral dos primitivos de sincronização

Add(UInt32, UInt32)

Origem:

Interlocked.cs

Importante

Esta API não está em conformidade com CLS.

Adiciona dois números inteiros sem sinal de 32 bits e substitui o primeiro inteiro pela soma, como uma operação atômica.

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

Parâmetros

location1

UInt32

Uma variável que contém o primeiro valor a ser adicionado. A soma dos dois valores é armazenada em location1.

value

UInt32

O valor a ser adicionado ao inteiro em location1.

Retornos

UInt32

O novo valor que foi armazenado em location1 por essa operação.

Atributos

CLSCompliantAttribute

Exceções

NullReferenceException

O endereço de location1 é um ponteiro null.

Add(UInt64, UInt64)

Origem:

Interlocked.cs

Importante

Esta API não está em conformidade com CLS.

Adiciona dois números inteiros sem sinal de 64 bits e substitui o primeiro inteiro pela soma, como uma operação atômica.

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

Parâmetros

location1

UInt64

Uma variável que contém o primeiro valor a ser adicionado. A soma dos dois valores é armazenada em location1.

value

UInt64

O valor a ser adicionado ao inteiro em location1.

Retornos

UInt64

O novo valor que foi armazenado em location1 por essa operação.

Atributos

CLSCompliantAttribute

Exceções

NullReferenceException

O endereço de location1 é um ponteiro null.