Partilhar via


Constantes definidas pelo usuário (Visual Basic)

Uma constante é um nome significativo que substitui um número ou cadeia de caracteres que não muda. As constantes armazenam valores que, como o nome indica, permanecem constantes durante toda a execução de um aplicativo. Você pode usar constantes que são definidas pelos controles ou componentes com os quais você trabalha, ou você pode criar o seu próprio. As constantes que você mesmo cria são descritas como definidas pelo usuário.

Você declara uma constante com a Const instrução, usando as mesmas diretrizes que faria para criar um nome de variável. Se Option Strict for On, você deve declarar explicitamente o tipo constante.

Utilização da Declaração Const

Uma Const instrução pode representar uma quantidade matemática ou de data/hora:

Const conPi = 3.14159265358979
Public Const conMaxPlanets As Integer = 9
Const conReleaseDate = #1/1/1995#

Ele também pode definir String constantes:

Public Const conVersion = "07.10.A"
Const conCodeName = "Enigma"

A expressão no lado direito do sinal de igual ( = ) é geralmente um número ou cadeia literal, mas também pode ser uma expressão que resulta em um número ou cadeia de caracteres (embora essa expressão não possa conter chamadas para funções). Você pode até mesmo definir constantes em termos de constantes definidas anteriormente:

Const conPi2 = conPi * 2

Escopo de constantes definidas pelo usuário

O escopo de uma Const instrução é o mesmo de uma variável declarada no mesmo local. Você pode especificar o escopo de qualquer uma das seguintes maneiras:

  • Para criar uma constante que existe apenas dentro de um procedimento, declare-a dentro desse procedimento.

  • Para criar uma constante disponível para todos os procedimentos dentro de uma classe, mas não para qualquer código fora desse módulo, declare-a na seção declarações da classe.

  • Para criar uma constante que está disponível para todos os membros de um assembly, mas não para clientes externos do assembly, declare-o usando a Friend palavra-chave na seção declarations da classe.

  • Para criar uma constante disponível em todo o aplicativo, declare-a usando a Public palavra-chave na seção declarações da classe.

Para obter mais informações, consulte Como declarar uma constante.

Evitar referências circulares

Como as constantes podem ser definidas em termos de outras constantes, é possível criar inadvertidamente um ciclo, ou referência circular, entre duas ou mais constantes. Um ciclo ocorre quando você tem duas ou mais constantes públicas, cada uma das quais é definida em termos da outra, como no exemplo a seguir:

Public Const conA = conB * 2
Public Const conB = conA / 2

Se ocorrer um ciclo, o Visual Basic gerará um erro de compilador.

Consulte também