Instrucción Const (Visual Basic)

Declara y define una o varias constantes.

Sintaxis

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

Partes

attributelist
Opcional. Lista de atributos que se aplican a todas las constantes declaradas en esta instrucción. Vea Lista de atributos entre corchetes angulares (" " y " < > ").

accessmodifier
Opcional. Use esta opción para especificar qué código puede tener acceso a estas constantes. Puede ser público, protegido, de confianza, de confianzaprotegido, privadoo privado protegido.

Shadows
Opcional. Use esta opción para volver a declarar y ocultar un elemento de programación en una clase base. Vea Sombras.

constantlist
Necesario. Lista de constantes que se declaran en esta instrucción.

constant [ , constant ... ]

Cada constant tiene la sintaxis y las partes siguientes:

constantname [ As datatype ] = initializer

Parte Descripción
constantname Necesario. Nombre de la constante. Vea Declared Element Names.
datatype Obligatorio si Option Strict es On . Tipo de datos de la constante.
initializer Necesario. Expresión que se evalúa en tiempo de compilación y se asigna a la constante.

Comentarios

Si tiene un valor que nunca cambia en la aplicación, puede definir una constante con nombre y usarla en lugar de un valor literal. Un nombre es más fácil de recordar que un valor. Puede definir la constante una sola vez y usarla en muchos lugares del código. Si en una versión posterior necesita volver a definir el valor, la instrucción es el único lugar Const donde debe realizar un cambio.

Solo puede usar Const en el nivel de módulo o procedimiento. Esto significa que el contexto de declaración de una variable debe ser una clase, estructura, módulo, procedimiento o bloque, y no puede ser un archivo de origen, un espacio de nombres o una interfaz. Para obtener más información, vea Declaration Contexts and Default Access Levels (Contextos de declaración y niveles de acceso predeterminados).

Las constantes locales (dentro de un procedimiento) tienen como valor predeterminado el acceso público y no se puede usar ningún modificador de acceso en ellas. Las constantes de miembro de clase y módulo (fuera de cualquier procedimiento) tienen como valor predeterminado el acceso privado y las constantes de miembro de estructura tienen como valor predeterminado el acceso público. Los niveles de acceso se pueden ajustar con los modificadores de acceso.

Reglas

  • Contexto de declaración. Una constante declarada en el nivel de módulo, fuera de cualquier procedimiento, es una constante de miembro; es un miembro de la clase, estructura o módulo que la declara.

    Una constante declarada en el nivel de procedimiento es una constante local; es local para el procedimiento o bloque que lo declara.

  • Atributos. Solo puede aplicar atributos a constantes miembro, no a constantes locales. Un atributo aporta información a los metadatos del ensamblado, lo que no es significativo para el almacenamiento temporal, como las constantes locales.

  • Modificadores. De forma predeterminada, todas las constantes Shared son Static , y ReadOnly . No se puede usar ninguna de estas palabras clave al declarar una constante.

    En el nivel de procedimiento, no puede usar Shadows ni ningún modificador de acceso para declarar constantes locales.

  • Varias constantes. Puede declarar varias constantes en la misma instrucción de declaración, especificando el constantname elemento para cada una de ellas. Varias constantes están separadas por comas.

Reglas de tipo de datos

  • Tipos de datos. La Const instrucción puede declarar el tipo de datos de una variable. Puede especificar cualquier tipo de datos o el nombre de una enumeración.

  • Tipo predeterminado. Si no especifica , datatype la constante toma el tipo de datos de initializer . Si especifica y datatype , el tipo de datos de debe poder convertirse en initializer initializer datatype . Si ni datatype ni initializer están presentes, el tipo de datos tiene como valor predeterminado Object .

  • Tipos diferentes. Puede especificar distintos tipos de datos para distintas constantes mediante una cláusula As independiente para cada variable que declare. Sin embargo, no se puede declarar que varias constantes sean del mismo tipo mediante una cláusula As común.

  • Inicialización. Debe inicializar el valor de cada constante en constantlist . Se usa initializer para proporcionar una expresión que se va a asignar a la constante. La expresión puede ser cualquier combinación de literales, otras constantes que ya están definidas y miembros de enumeración que ya están definidos. Puede usar operadores aritméticos y lógicos para combinar estos elementos.

    No se pueden usar variables o funciones en initializer . Sin embargo, puede usar palabras clave de conversión como CByte y CShort . También puede usar si lo llama con una constante o un argumento, ya que se AscW puede evaluar en tiempo de String Char compilación.

Comportamiento

  • Ámbito. Solo se puede acceder a las constantes locales desde su procedimiento o bloque. Las constantes miembro son accesibles desde cualquier lugar dentro de su clase, estructura o módulo.

  • Calificación. El código fuera de una clase, estructura o módulo debe calificar el nombre de una constante miembro con el nombre de esa clase, estructura o módulo. El código fuera de un procedimiento o bloque no puede hacer referencia a ninguna constante local dentro de ese procedimiento o bloque.

Ejemplo 1

En el ejemplo siguiente se usa Const la instrucción para declarar constantes para su uso en lugar de valores literales.

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

Ejemplo 2

Si define una constante con el tipo de datos , Visual Basic compilador le Object proporciona el tipo de , en lugar de initializer Object . En el ejemplo siguiente, la constante naturalLogBase tiene el tipo en tiempo de ejecución Decimal .

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

En el ejemplo anterior se usa el método en el objeto devuelto por el ToString Type operador GetType, porque no se puede Type convertir al uso de String CStr .

Consulta también