Compartilhar via


Constantes definidas pelo usuário (Visual Basic)

Uma constante é um nome significativo que ocupa o lugar de um número ou cadeia de caracteres que não é alterado. Constantes armazenam valores que, como o nome implica, permanecem constantes durante a execução de um aplicativo. Você pode usar constantes definidas pelos controles ou componentes com os quais trabalha ou pode criar suas próprias. As constantes que você cria por conta própria são descritas como definidas pelo usuário.

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

Uso da Instruçã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 uma cadeia de caracteres 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 de User-Defined

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

  • Para criar uma constante que exista somente 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 disponível para todos os membros de um assembly, mas não para clientes externos do assembly, declare-a usando a Friend palavra-chave na seção declarações 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.

Evitando 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 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 do compilador.

Confira também