Compartilhar via

Instrução Const (Visual Basic)

Declara e define uma ou mais constantes.

Sintaxe

[ <attributelist> ] [ accessmodifier ] [ Shadows ]
Const constantlist

Partes

attributelist
Opcional. Lista de atributos que se aplicam a todas as constantes declaradas nesta instrução. Consulte a Lista de Atributos em colchetes angulares ("<" e ">").

accessmodifier
Opcional. Use isso para especificar qual código pode acessar essas constantes. Pode ser público, protegido, amigo, amigo protegido, privado ou privado protegido.

Shadows
Opcional. Use isso para reimplantar e ocultar um elemento de programação em uma classe base. Veja Sombras.

constantlist
Obrigatório Lista de constantes que estão sendo declaradas nesta instrução.

constant [ , constant ... ]

Cada constant um tem a seguinte sintaxe e partes:

constantname [ As datatype ] = initializer

Parte Descrição
constantname Obrigatório Nome da constante. Consulte nomes de elementos declarados.
datatype Necessário se Option Strict for On. Tipo de dados da constante.
initializer Obrigatório Expressão que é avaliada no tempo de compilação e atribuída à constante.

Observações

Se você tiver um valor que nunca muda em seu aplicativo, poderá definir uma constante nomeada e usá-la no lugar de um valor literal. Um nome é mais fácil de lembrar do que um valor. Você pode definir a constante apenas uma vez e usá-la em muitos lugares em seu código. Se em uma versão posterior você precisar redefinir o valor, a Const instrução será o único local em que você precisa fazer uma alteração.

Você pode usar Const somente no nível do módulo ou do procedimento. Isso significa que o contexto de declaração de uma variável deve ser uma classe, estrutura, módulo, procedimento ou bloco e não pode ser um arquivo de origem, namespace ou interface. Para obter mais informações, consulte contextos de declaração e níveis de acesso padrão.

Constantes locais (dentro de um procedimento) são padrão para acesso público e você não pode usar modificadores de acesso nelas. Constantes de membro de classe e módulo (fora de qualquer procedimento) padrão para acesso privado e constantes de membro de estrutura padrão para acesso público. Você pode ajustar seus níveis de acesso com os modificadores de acesso.

Regras

  • Contexto da Declaração. Uma constante declarada no nível do módulo, fora de qualquer procedimento, é uma constante de membro; é um membro da classe, estrutura ou módulo que a declara.

    Uma constante declarada no nível do procedimento é uma constante local; é local para o procedimento ou bloco que o declara.

  • Atributos. Você pode aplicar atributos somente a constantes de membro, não a constantes locais. Um atributo contribui com informações para os metadados do assembly, o que não é significativo para o armazenamento temporário, como constantes locais.

  • Modificadores. Por padrão, todas as constantes são Shared, Statice ReadOnly. Você não pode usar nenhuma dessas palavras-chave ao declarar uma constante.

    No nível do procedimento, você não pode usar Shadows ou quaisquer modificadores de acesso para declarar constantes locais.

  • Várias constantes. Você pode declarar várias constantes na mesma instrução de declaração, especificando a constantname parte para cada uma delas. Várias constantes são separadas por vírgulas.

Regras de tipo de dados

  • Tipos de dados. A Const instrução pode declarar o tipo de dados de uma variável. Você pode especificar qualquer tipo de dados ou o nome de uma enumeração.

  • Tipo padrão. Se você não especificar datatype, a constante usará o tipo de dados de initializer. Se você especificar ambos datatype e initializer, o tipo de dados deve initializer ser conversível para datatype. Se nem estiver datatypeinitializer presente, o tipo de dados usará como padrão Object.

  • Tipos diferentes. Você pode especificar tipos de dados diferentes para constantes diferentes usando uma cláusula separada As para cada variável declarada. No entanto, você não pode declarar várias constantes como do mesmo tipo usando uma cláusula comum As .

  • Inicialização. Você deve inicializar o valor de cada constante em constantlist. Você usa initializer para fornecer uma expressão a ser atribuída à constante. A expressão pode ser qualquer combinação de literais, outras constantes que já estão definidas e membros de enumeração que já estão definidos. Você pode usar operadores aritméticos e lógicos para combinar esses elementos.

    Você não pode usar variáveis ou funções em initializer. No entanto, você pode usar palavras-chave de conversão como CByte e CShort. Você também pode usá-lo AscW se chamá-lo com uma constante String ou Char argumento, já que isso pode ser avaliado em tempo de compilação.

Comportamento

  • Escopo. As constantes locais são acessíveis somente de dentro de seu procedimento ou bloco. As constantes de membro são acessíveis de qualquer lugar dentro de sua classe, estrutura ou módulo.

  • Qualificação. O código fora de uma classe, estrutura ou módulo deve qualificar o nome de uma constante de membro com o nome dessa classe, estrutura ou módulo. O código fora de um procedimento ou bloco não pode se referir a nenhuma constante local dentro desse procedimento ou bloco.

Exemplo 1

O exemplo a seguir usa a Const instrução para declarar constantes para uso no lugar de valores literais.

' The following statements declare constants.
Const maximum As Long = 459
Public Const helpString As String = "HELP"
Private Const startValue As Integer = 5

Exemplo 2

Se você definir uma constante com o tipo Objectde dados, o compilador do Visual Basic fornecerá o tipo de initializer, em vez de Object. No exemplo a seguir, a constante naturalLogBase tem o tipo Decimalde tempo de execução.

Const naturalLogBase As Object = CDec(2.7182818284)
MsgBox("Run-time type of constant naturalLogBase is " &
    naturalLogBase.GetType.ToString())

O exemplo anterior usa o ToString método no Type objeto retornado pelo Operador GetType, porque Type não pode ser convertido em String uso CStr.

Consulte também

  • Last updated on