Compartilhar via


Declaração Const (Visual Basic)

Declara e define uma ou mais constantes.

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

Partes

  • attributelist
    Opcional.Lista de atributos que se aplicam a todas as constantes declaradas nessa declaração.Consulte Lista de atributos entre colchetes ("<" e ">").

  • accessmodifier
    Opcional.Use isso para especificar qual código pode acessar essas constantes.Pode ser Público (Visual Basic), Protegido (Visual Basic), Amigo (Visual Basic), Protected Friend, ou Private (Visual Basic).

  • Shadows
    Opcional.Use isto para redeclarar e ocultar um elemento de programação numa classe base.Acesse Shadows.

  • constantlist
    Obrigatório.Lista de constantes que está sendo declarada nessa declaração.

    constant[ , constant ... ]

    Cada constant possui a seguinte sintaxe e partes:

    constantname[ As datatype ] = initializer

    Parte

    Descrição

    constantname

    Obrigatório.Nome da constante.SeeNomes de Elementos Declarados.

    datatype

    Necessário se Option Strict estiver On.Tipo de dados da constante.

    initializer

    Obrigatório.Expressão que é avaliada em tempo de compilação e atribuída à constante.

Comentários

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

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

Constantes padrão locais (dentro de um procedimento) para acesso público e você não pode usar quaisquer modificadores de acesso nelas.Constantes de classes e membros de 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 os níveis de acesso com os modificadores de acesso.

Regras

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

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

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

  • Modificadores Por padrão, todas as constantes são Shared, Static e ReadOnly.Não é possível usar qualquer uma dessas palavras-chave ao declarar uma constante.

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

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

Regras de Tipo de Dados

  • Tipos de dados A instrução Const pode declarar a 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 tem o tipo de dados do initializer.Se você especificar datatype e initializer, o tipo de dados do initializer deve ser conversível para datatype.Se nem datatype ou initializer estiverem presentes, o tipo de dados padrão será Object.

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

  • Inicialização. Você deve inicializar o valor de cada constante na 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 no initializer.No entanto, você pode usar palavras-chave de conversão, como CByte e CShort.Você também pode usar AscW se você chamá-lo com uma constante String ou argumento Char, desde que possa ser avaliado em tempo de compilação.

Comportamento

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

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

Exemplo

O exemplo a seguir utiliza a declaração Const 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

Se você define uma constante com o tipo de dados Object, o compilador Visual Basic dá a ele o tipo de initializer, em vez de Object.No exemplo a seguir, a constante naturalLogBase tem o tipo de tempo de execução Decimal.

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

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

Consulte também

Conceitos

Conversões explícita e implícita 

Constantes Intrínsecas e Enumerações

Referência

Declaração Enum (Visual Basic)

Diretriz #Const

Instrução Dim (Visual Basic)

ReDim demonstrativo (Visual Basic)

Funções de conversão de tipo 

Funções Asc, AscW

Outros recursos

Constantes e Enumerations no Visual Basic