Compartilhar via


const (Referência de C#)

Use a palavra-chave const para declarar um campo constante ou uma constante local. Campos e locais constantes não são variáveis ​​e não podem ser modificados. As constantes podem ser números, valores boolianos, cadeias de caracteres ou uma referência nula. Não crie uma constante para representar informações que você espera mudar a qualquer momento. Por exemplo, não use um campo constante para armazenar o preço de um serviço, um número de versão de produto ou a marca de uma empresa. Esses valores podem mudar ao longo do tempo e como os compiladores propagam constantes, outro código compilado com as bibliotecas terá que ser recompilado para ver as alterações. Veja também a palavra-chave readonly. Por exemplo:

const int X = 0;
public const double GravitationalConstant = 6.673e-11;
private const string ProductName = "Visual C#";

A partir do C# 10, as cadeias de caracteres interpoladas podem ser constantes, se todas as expressões usadas também forem cadeias de caracteres constantes. Esse recurso pode melhorar o código que cria cadeias de caracteres constantes:

const string Language = "C#";
const string Platform = ".NET";
const string FullProductName = $"{Platform} - Language: {Language}";

Comentários

O tipo de uma declaração constante especifica o tipo dos membros que a declaração apresenta. O inicializador de uma constante local ou de um campo constante deve ser uma expressão constante que pode ser implicitamente convertida para o tipo de destino.

Uma expressão constante é uma expressão que pode ser completamente avaliada em tempo de compilação. Portanto, os únicos valores possíveis para constantes de tipos de referência são cadeias de caracteres e uma referência nula.

A declaração constante pode declarar constantes múltiplas como:

public const double X = 1.0, Y = 2.0, Z = 3.0;

O modificador static não é permitido em uma declaração constante.

A constante pode fazer parte de uma expressão constante, como a seguir:

public const int C1 = 5;
public const int C2 = C1 + 100;

Observação

A palavra-chave readonly é diferente da palavra-chave const. O campo const pode ser inicializado apenas na declaração do campo. Um campo readonly pode ser inicializado na declaração ou em um construtor. Portanto, campos readonly podem ter valores diferentes dependendo do construtor usado. Além disso, embora um campo const seja uma constante em tempo de compilação, o campo readonly pode ser usado para constantes de tempo de execução, como nesta linha: public static readonly uint l1 = (uint)DateTime.Now.Ticks;

Exemplos

public class ConstTest
{
    class SampleClass
    {
        public int x;
        public int y;
        public const int C1 = 5;
        public const int C2 = C1 + 5;

        public SampleClass(int p1, int p2)
        {
            x = p1;
            y = p2;
        }
    }

    static void Main()
    {
        var mC = new SampleClass(11, 22);
        Console.WriteLine($"x = {mC.x}, y = {mC.y}");
        Console.WriteLine($"C1 = {SampleClass.C1}, C2 = {SampleClass.C2}");
    }
}
/* Output
    x = 11, y = 22
    C1 = 5, C2 = 10
*/

O seguinte exemplo demonstra como declarar uma constante local:

public class SealedTest
{
    static void Main()
    {
        const int C = 707;
        Console.WriteLine($"My local constant = {C}");
    }
}
// Output: My local constant = 707

Especificação da linguagem C#

Para obter mais informações, confira as seguintes seções da especificação da linguagem C#:

Confira também