Partilhar via


CA1802: Usar literais onde for apropriado

TypeName

UseLiteralsWhereAppropriate

CheckId

CA1802

<strong>Categoria</strong>

Microsoft.Performance

Alteração significativa

Não-separável

Causa

Um campo é declarado static e readonly (Shared e ReadOnly na Visual Basic) e é inicializada com um valor que seja computáveis em tempo de compilação.

Descrição da regra

O valor de um staticreadonly campo é calculado em tempo de execução quando o construtor estático para o tipo declarativo é chamado.Se a staticreadonly campo é inicializado quando ela é declarada e um construtor estático não foi declarado explicitamente, o compilador emite um construtor estático para inicializar o campo.

O valor de um const campo é calculado em tempo de compilação e armazenado nos metadados, que aumenta o desempenho de tempo de execução quando ele é comparado com um staticreadonly campo.

Como o valor atribuído ao campo de destino é computáveis em tempo de compilação, altere a declaração para um const de campo para que o valor é calculado em tempo de compilação em vez de em tempo de execução.

Como corrigir violações

Para corrigir uma violação desta regra, substitua o static e readonly modificadores com o const modificador.

Quando suprimir avisos

É seguro eliminar um aviso esta regra ou desativar a regra, se o desempenho não é uma preocupação.

Exemplo

O exemplo a seguir mostra um tipo, UseReadOnly, que viola a regra e um tipo, UseConstant, que satisfaça a regra.

Imports System

Namespace PerformanceLibrary

   ' This class violates the rule.
   Public Class UseReadOnly

      Shared ReadOnly x As Integer = 3
      Shared ReadOnly y As Double = x + 2.1
      Shared ReadOnly s As String = "readonly"

   End Class

   ' This class satisfies the rule.
   Public Class UseConstant

      Const x As Integer = 3
      Const y As Double = x + 2.1
      Const s As String = "const"

   End Class

End Namespace
using System;

namespace PerformanceLibrary
{
   // This class violates the rule.
   public class UseReadOnly
   {
      static readonly int x = 3;
      static readonly double y = x + 2.1;
      static readonly string s = "readonly";
   }

   // This class satisfies the rule.
   public class UseConstant
   {
      const int x = 3;
      const double y = x + 2.1;
      const string s = "const";
   }
}