Remover a atribuição de valor desnecessária (IDE0059)

  • Artigo
Propriedade Valor
ID da regra IDE0059
Título Remover atribuição de valor desnecessária
Categoria Estilo
Subcategoria Regras de código desnecessárias (preferências no nível da expressão)
Linguagens aplicáveis C# e Visual Basic
Opções csharp_style_unused_value_assignment_preference
visual_basic_style_unused_value_assignment_preference

Visão geral

Essa regra sinaliza as atribuições de valor desnecessárias. Por exemplo:

// IDE0059: value written to 'v' is never
// read, so assignment to 'v' is unnecessary.
int v = Compute();
v = Compute2();

Você pode executar uma das ações a seguir para corrigir essa violação:

  • Se a expressão do lado direito da atribuição não tiver efeitos colaterais, remova a expressão ou a instrução de atribuição inteira. Isso melhora o desempenho evitando computação desnecessária.

    int v = Compute2();

  • Se a expressão no lado direito da atribuição tiver efeitos colaterais, substitua o lado esquerdo da atribuição por um discard (somente C#) ou uma variável local que nunca foi usada. Descarta melhorar a clareza do código mostrando explicitamente a intenção de descartar um valor não utilizado.

    _ = Compute();
int v = Compute2();

Opções

As opções para isso especificam se prefere usar um discard ou uma variável local não utilizada:

Para obter informações sobre como configurar as opções, consulte Formato da opção.

csharp_style_unused_value_assignment_preference

Propriedade Valor Descrição
Nome da opção csharp_style_unused_value_assignment_preference
Linguagens aplicáveis C#
Valores da opção discard_variable Preferir usar um discard ao atribuir um valor que não é utilizado
unused_local_variable Prefira usar uma variável local ao atribuir um valor não utilizado
Valor da opção padrão discard_variable 
// csharp_style_unused_value_assignment_preference = discard_variable
int GetCount(Dictionary<string, int> wordCount, string searchWord)
{
    _ = wordCount.TryGetValue(searchWord, out var count);
    return count;
}

// csharp_style_unused_value_assignment_preference = unused_local_variable
int GetCount(Dictionary<string, int> wordCount, string searchWord)
{
    var unused = wordCount.TryGetValue(searchWord, out var count);
    return count;
}

visual_basic_style_unused_value_assignment_preference

Propriedade Valor Descrição
Nome da opção visual_basic_style_unused_value_assignment_preference
Linguagens aplicáveis Visual Basic
Valores da opção unused_local_variable Prefira usar uma variável local ao atribuir um valor não utilizado
Valor da opção padrão unused_local_variable 
' visual_basic_style_unused_value_assignment_preference = unused_local_variable
Dim unused = Computation()

Suprimir um aviso

Se você quiser suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem para desabilitar e, em seguida, reabilite a regra.

#pragma warning disable IDE0059
// The code that's violating the rule is on this line.
#pragma warning restore IDE0059

Para desabilitar a regra em um arquivo, uma pasta ou um projeto, defina a severidade como none no arquivo de configuração.

[*.{cs,vb}]
dotnet_diagnostic.IDE0059.severity = none

Para desabilitar todas as regras de estilo de código, defina a severidade da categoria Style como none no arquivo de configuração.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

Para obter mais informações, confira Como suprimir avisos de análise de código.

Propriedade Valor
ID da regra IDE0059
Título O valor não é utilizado
Categoria Estilo
Linguagens aplicáveis F#
Opções Nenhum

Visão geral

Essa regra sinaliza as atribuições de valor desnecessárias. Por exemplo, answer não é usado no snippet a seguir:

type T() =
    let answer = 42

Confira também