Operadores de atribuição (referência C#)

O operador = de atribuição atribui o valor de seu operando direito a uma variável, uma propriedade ou um elemento indexador dado por seu operando esquerdo. O resultado de uma expressão de atribuição é o valor atribuído ao operando esquerdo. O tipo do operando direito deve ser o mesmo que o tipo do operando esquerdo ou implicitamente conversível para ele.

O operador = de atribuição é associativo à direita, ou seja, uma expressão da forma

a = b = c

é avaliada como

a = (b = c)

O exemplo a seguir demonstra o uso do operador de atribuição com uma variável local, uma propriedade e um elemento indexador como seu operando esquerdo:

List<double> numbers = [1.0, 2.0, 3.0];

Console.WriteLine(numbers.Capacity);
numbers.Capacity = 100;
Console.WriteLine(numbers.Capacity);
// Output:
// 4
// 100

int newFirstElement;
double originalFirstElement = numbers[0];
newFirstElement = 5;
numbers[0] = newFirstElement;
Console.WriteLine(originalFirstElement);
Console.WriteLine(numbers[0]);
// Output:
// 1
// 5

O operando esquerdo de uma atribuição recebe o valor do operando direito. Quando os operandos são de tipos de valor, a atribuição copia o conteúdo do operando direito. Quando os operandos são de tipos de referência, a atribuição copia a referência ao objeto.

Isso é chamado de atribuição de valor: o valor é atribuído.

Atribuição de ref

A atribuição= ref Ref torna seu operando esquerdo um alias para o operando direito, como demonstra o exemplo a seguir:

void Display(double[] s) => Console.WriteLine(string.Join(" ", s));

double[] arr = { 0.0, 0.0, 0.0 };
Display(arr);

ref double arrayElement = ref arr[0];
arrayElement = 3.0;
Display(arr);

arrayElement = ref arr[arr.Length - 1];
arrayElement = 5.0;
Display(arr);
// Output:
// 0 0 0
// 3 0 0
// 3 0 5

No exemplo anterior, a variávelarrayElement de referência local é inicializada como um alias para o primeiro elemento de matriz. Em seguida, ele é ref reatribuído para se referir ao último elemento da matriz. Como é um alias, quando você atualiza seu valor com um operador =de atribuição comum, o elemento de matriz correspondente também é atualizado.

O operando esquerdo da atribuição pode ser uma variável de ref referência local, um ref campo e um refparâmetro , outou inmétodo. Ambos os operandos devem ser do mesmo tipo.

Atribuição composta

Para um operador opbinário , uma expressão de atribuição composta do formulário

x op= y

é equivalente a

x = x op y

só que só é x avaliado uma vez.

A atribuição composta é suportada por operadores aritméticos, lógicos booleanos e lógicos e de deslocamento bitwise.

Atribuição de coalescência nula

Você pode usar o operador ??= de atribuição de coalescência nula para atribuir o valor de seu operando direito ao operando esquerdo somente se o operando esquerdo for avaliado como null. Para mais informações, consulte o ?? e ?? = artigo dos operadores .

Capacidade de sobrecarga do operador

Um tipo definido pelo usuário não pode sobrecarregar o operador de atribuição. No entanto, um tipo definido pelo usuário pode definir uma conversão implícita para outro tipo. Dessa forma, o valor de um tipo definido pelo usuário pode ser atribuído a uma variável, uma propriedade ou um elemento indexador de outro tipo. Para obter mais informações, consulte Operadores de conversão definidos pelo usuário.

Um tipo definido pelo usuário não pode sobrecarregar explicitamente um operador de atribuição composta. No entanto, se um tipo definido pelo usuário sobrecarrega um operador opbinário, o op= operador, se existir, também é implicitamente sobrecarregado.

Especificação da linguagem C#

Para obter mais informações, consulte a seção Operadores de atribuição da especificação da linguagem C#.

Consulte também

• Operadores e expressões C#
• palavra-chave ref
• Usar atribuição composta (regras de estilo IDE0054 e IDE0074)