Partilhar via


Interlocked.Add Método

Definição

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
Origem:
Interlocked.CoreCLR.cs
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

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

Exceções

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

Aplica-se a

Add(Int64, Int64)

Origem:
Interlocked.CoreCLR.cs
Origem:
Interlocked.CoreCLR.cs
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

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

Exceções

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

Aplica-se a

Add(UInt32, UInt32)

Origem:
Interlocked.cs
Origem:
Interlocked.cs
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

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

Atributos

Exceções

O endereço de location1 é um ponteiro null.

Aplica-se a

Add(UInt64, UInt64)

Origem:
Interlocked.cs
Origem:
Interlocked.cs
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

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

Atributos

Exceções

O endereço de location1 é um ponteiro null.

Aplica-se a