Instrucciones en Visual Basic

Una instrucción en Visual Basic es una instrucción completa. Puede contener palabras clave, operadores, variables, constantes y expresiones. Cada declaración pertenece a una de las siguientes categorías:

• Instrucciones de declaración, que asignan un nombre a una variable, una constante o un procedimiento, y también pueden especificar un tipo de datos.

• Instrucciones Executable, que inician acciones. Estas instrucciones pueden llamar a un método o función, y pueden recorrer en bucle o ramificarse a través de bloques de código. Las instrucciones ejecutables incluyen instrucciones de asignación, que asignan un valor o expresión a una variable o constante.

En este tema se describe cada categoría. Además, en este tema se describe cómo combinar varias instrucciones en una sola línea y cómo continuar una instrucción en varias líneas.

Instrucciones de declaración

Las instrucciones de declaración se usan para nombrar y definir procedimientos, variables, propiedades, matrices y constantes. Al declarar un elemento de programación, también puede definir su tipo de datos, nivel de acceso y ámbito. Para obtener más información, vea Características de elemento declaradas.

En el ejemplo siguiente se incluyen tres declaraciones.

Public Sub ApplyFormat()
    Const limit As Integer = 33
    Dim thisWidget As New widget
    ' Insert code to implement the procedure.
End Sub

La primera declaración es la instrucción Sub. Junto con su instrucción coincidente End Sub , declara un procedimiento denominado applyFormat. También especifica que applyFormat es Public, lo que significa que cualquier código que pueda hacer referencia a él puede llamarlo.

La segunda declaración es la Const instrucción , que declara la constante limit, especificando el Integer tipo de datos y un valor de 33.

La tercera declaración es la Dim instrucción , que declara la variable thisWidget. El tipo de datos es un objeto específico, es decir, un objeto creado a partir de la Widget clase . Puede declarar una variable para que sea de cualquier tipo de datos elemental o de cualquier tipo de objeto que se exponga en la aplicación que esté usando.

Valores iniciales

Cuando se ejecuta el código que contiene una instrucción de declaración, Visual Basic reserva la memoria necesaria para el elemento declarado. Si el elemento contiene un valor, Visual Basic lo inicializa en el valor predeterminado para su tipo de datos. Para más información, consulte "Comportamiento" en Instrucción Dim.

Puede asignar un valor inicial a una variable como parte de su declaración, como se muestra en el ejemplo siguiente.

Dim m As Integer = 45
' The preceding declaration creates m and assigns the value 45 to it.

Si una variable es una variable de objeto, puede crear explícitamente una instancia de su clase al declararla mediante la palabra clave New Operator , como se muestra en el ejemplo siguiente.

Dim f As New FileInfo("filename")

Tenga en cuenta que el valor inicial que especifique en una instrucción de declaración no se asigna a una variable hasta que la ejecución alcance su instrucción de declaración. Hasta ese momento, la variable contiene el valor predeterminado para su tipo de datos.

Instrucciones ejecutables

Una instrucción ejecutable realiza una acción. Puede llamar a un procedimiento, ramificarse a otro lugar del código, recorrer varias instrucciones o evaluar una expresión. Una instrucción de asignación es un caso especial de una instrucción ejecutable.

En el ejemplo siguiente se usa una If...Then...Else estructura de control para ejecutar diferentes bloques de código en función del valor de una variable. Dentro de cada bloque de código, un For...Next bucle ejecuta un número especificado de veces.

Public Sub StartWidget(ByVal aWidget As widget,
    ByVal clockwise As Boolean, ByVal revolutions As Integer)
    Dim counter As Integer
    If clockwise = True Then
        For counter = 1 To revolutions
            aWidget.SpinClockwise()
        Next counter
    Else
        For counter = 1 To revolutions
            aWidget.SpinCounterClockwise()
        Next counter
    End If
End Sub

La If instrucción del ejemplo anterior comprueba el valor del parámetro clockwise. Si el valor es True, llama al método spinClockwise de aWidget. Si el valor es False, llama al método spinCounterClockwise de aWidget. La estructura de If...Then...Else control termina con End If.

El For...Next bucle dentro de cada bloque llama al método adecuado un número de veces igual al valor del revolutions parámetro.

Instrucciones de asignación

Las instrucciones de asignación llevan a cabo operaciones de asignación, que constan de tomar el valor en el lado derecho del operador de asignación (=) y almacenarlo en el elemento de la izquierda, como en el ejemplo siguiente.

v = 42

En el ejemplo anterior, la instrucción de asignación almacena el valor literal 42 en la variable v.

Elementos de programación aptos

El elemento de programación del lado izquierdo del operador de asignación debe poder aceptar y almacenar un valor. Esto significa que debe ser una variable o propiedad que no sea ReadOnly o debe ser un elemento de matriz. En el contexto de una instrucción de asignación, este elemento se denomina a veces lvalue, para "valor a la izquierda".

El valor del lado derecho del operador de asignación se genera mediante una expresión, que puede constar de cualquier combinación de literales, constantes, variables, propiedades, elementos de matriz, otras expresiones o llamadas de función. Esto se ilustra en el siguiente ejemplo:

x = y + z + FindResult(3)

En el ejemplo anterior se agrega el valor mantenido en la variable y al valor mantenido en la variable zy, a continuación, se agrega el valor devuelto por la llamada a la función findResult. A continuación, el valor total de esta expresión se almacena en la variable x.

Tipos de datos en instrucciones de asignación

Además de los valores numéricos, el operador de asignación también puede asignar String valores, como se muestra en el ejemplo siguiente.

Dim a, b As String
a = "String variable assignment"
b = "Con" & "cat" & "enation"
' The preceding statement assigns the value "Concatenation" to b.

También puede asignar Boolean valores mediante un Boolean literal o una Boolean expresión, como se muestra en el ejemplo siguiente.

Dim r, s, t As Boolean
r = True
s = 45 > 1003
t = 45 > 1003 Or 45 > 17
' The preceding statements assign False to s and True to t.

Del mismo modo, puede asignar valores adecuados a los elementos de programación de tipo de datos Char, Date o Object. También puede asignar una instancia de objeto a un elemento declarado como de la clase desde la que se crea esa instancia.

Instrucciones de asignación compuestas

Las instrucciones de asignación compuestas realizan primero una operación en una expresión antes de asignarla a un elemento de programación. En el ejemplo siguiente se muestra uno de estos operadores, , +=que incrementa el valor de la variable en el lado izquierdo del operador por el valor de la expresión a la derecha.

n += 1

En el ejemplo anterior se agrega 1 al valor de ny, a continuación, se almacena ese nuevo valor en n. Es un equivalente abreviado de la siguiente instrucción:

n = n + 1

Se pueden realizar diversas operaciones de asignación compuestas mediante operadores de este tipo. Para obtener una lista de estos operadores y más información sobre ellos, vea Operadores de asignación.

El operador de asignación de concatenación (&=) es útil para agregar una cadena al final de cadenas ya existentes, como se muestra en el ejemplo siguiente.

Dim q As String = "Sample "
q &= "String"
' q now contains "Sample String".

Conversiones de tipos en instrucciones de asignación

El valor que asigne a una variable, propiedad o elemento de matriz debe ser de un tipo de datos adecuado para ese elemento de destino. En general, debe intentar generar un valor del mismo tipo de datos que el del elemento de destino. Sin embargo, algunos tipos se pueden convertir a otros tipos durante la asignación.

Para obtener información sobre la conversión entre tipos de datos, vea Conversiones de tipos en Visual Basic. En resumen, Visual Basic convierte automáticamente un valor de un tipo determinado en cualquier otro tipo al que amplía. Una conversión de ampliación es una en que siempre se realiza correctamente en tiempo de ejecución y no pierde ningún dato. Por ejemplo, Visual Basic convierte un Integer valor en Double cuando sea adecuado, ya que Integer amplía a Double. Para obtener más información, consulta Widening and Narrowing Conversions.

Las conversiones de reducción (aquellas que no son de ampliación) conllevan un riesgo de error en tiempo de ejecución o de pérdida de datos. Puede realizar una conversión de restricción explícitamente mediante una función de conversión de tipos, o bien puede dirigir al compilador para realizar todas las conversiones implícitamente estableciendo Option Strict Off. Para obtener más información, vea Conversiones implícitas y explícitas.

Colocación de varias instrucciones en una línea

Puede tener varias instrucciones en una sola línea separadas por el carácter de dos puntos (:). Esto se ilustra en el siguiente ejemplo:

Dim sampleString As String = "Hello World" : MsgBox(sampleString)

Aunque ocasionalmente resulta conveniente, esta forma de sintaxis hace que el código sea difícil de leer y mantener. Por lo tanto, se recomienda mantener una instrucción en una línea.

Continuación de una instrucción en varias líneas

Normalmente, una instrucción cabe en una línea, pero cuando es demasiado larga, puede continuarla en la siguiente mediante una secuencia de continuación de línea, que consta de un espacio seguido de un carácter de subrayado (_) seguido de un retorno de carro. En el siguiente ejemplo, la instrucción ejecutable MsgBox se extiende sobre dos líneas.

Public Sub DemoBox()
    Dim nameVar As String
    nameVar = "John"
    MsgBox("Hello " & nameVar _
        & ". How are you?")
End Sub

Continuación de línea implícita

En muchos casos, puede continuar una declaración en la siguiente línea sin usar el carácter de subrayado (_). Los siguientes elementos de sintaxis continúan implícitamente la instrucción en la siguiente línea de código.

• Después de una coma (,). Por ejemplo:

  Public Function GetUsername(ByVal username As String,
                              ByVal delimiter As Char,
                              ByVal position As Integer) As String
  
      Return username.Split(delimiter)(position)
  End Function
  

• Después de un paréntesis abierto (() o antes de un paréntesis de cierre ()). Por ejemplo:

  Dim username = GetUsername(
      Security.Principal.WindowsIdentity.GetCurrent().Name,
      CChar("\"),
      1
    )
  

• Detrás de una llave de apertura ({) o delante de una llave de cierre (}). Por ejemplo:

  Dim customer = New Customer With {
    .Name = "Terry Adams",
    .Company = "Adventure Works",
    .Email = "terry@www.adventure-works.com"
  }
  

  Para obtener más información, vea Inicializadores de objetos: Tipos con nombre y anónimos o inicializadores de colección.

• Detrás de una expresión insertada de apertura (<%=) o delate de una expresión insertada de cierre (%>) dentro de un literal XML. Por ejemplo:

  Dim customerXml = <Customer>
                        <Name>
                            <%=
                                customer.Name
                            %>
                        </Name>
                        <Email>
                            <%=
                                customer.Email
                            %>
                        </Email>
                    </Customer>
  

  Para más información, consulte Expresiones insertadas en XML.

• Detrás del operador de concatenación (&). Por ejemplo:

  cmd.CommandText = 
      "SELECT * FROM Titles JOIN Publishers " &
      "ON Publishers.PubId = Titles.PubID " &
      "WHERE Publishers.State = 'CA'"
  

  Para obtener más información, consulte Operadores enumerados por funcionalidad.

• Detrás de los operadores de asignación (=, , &=:=, +=, -=*=/=\=^=<<=, >>=). Por ejemplo:

  Dim fileStream =
    My.Computer.FileSystem.
      OpenTextFileReader(filePath)
  

  Para obtener más información, consulte Operadores enumerados por funcionalidad.

• Después de los operadores binarios (+, -, /, *, Mod, <>, <, >, <=, >=, ^, >>, <<, And, AndAlso, Or, OrElse, Like, Xor) dentro de una expresión. Por ejemplo:

  Dim memoryInUse =
    My.Computer.Info.TotalPhysicalMemory +
    My.Computer.Info.TotalVirtualMemory -
    My.Computer.Info.AvailablePhysicalMemory -
    My.Computer.Info.AvailableVirtualMemory
  

  Para obtener más información, consulte Operadores enumerados por funcionalidad.

• Después de los operadores Is y IsNot. Por ejemplo:

  If TypeOf inStream Is 
    IO.FileStream AndAlso
    inStream IsNot
    Nothing Then
  
      ReadFile(inStream)
  
  End If
  

  Para obtener más información, consulte Operadores enumerados por funcionalidad.

• Detrás de un carácter calificador de miembro (.) y delante del nombre del miembro. Por ejemplo:

  Dim fileStream =
    My.Computer.FileSystem.
      OpenTextFileReader(filePath)
  

  Sin embargo, debe incluir un carácter de continuación de línea (_) después de un carácter calificador de miembro cuando use la instrucción With o proporcione valores en la lista de inicialización para un tipo. Considere la posibilidad de dividir la línea después del operador de asignación (por ejemplo, =) cuando se usan With instrucciones o listas de inicialización de objetos. Por ejemplo:

  ' Not allowed:
  ' Dim aType = New With { .
  '    PropertyName = "Value"
  
  ' Allowed:
  Dim aType = New With {.PropertyName =
      "Value"}
  
  
  
  Dim log As New EventLog()
  
  ' Not allowed:
  ' With log
  '    .
  '      Source = "Application"
  ' End With
  
  ' Allowed:
  With log
      .Source =
        "Application"
  End With
  

  Para más información, consulte Instrucción With... End With o Inicializadores de objetos: Tipos con nombre y anónimos.

• Detrás de un calificador de propiedad del eje XML (. o .@...). Sin embargo, debe incluir un carácter de continuación de línea (_) cuando especifique un calificador de miembro cuando use la palabra clave With. Por ejemplo:

  Dim customerName = customerXml.
    <Name>.Value
  
  Dim customerEmail = customerXml...
    <Email>.Value
  

  Para obtener más información, vea Propiedades del eje XML.

• Después de un signo menor que (<) o antes de un signo mayor que (>) al especificar un atributo . También después de un signo mayor que (>) al especificar un atributo. Sin embargo, debe incluir un carácter de continuación de línea (_) al especificar atributos de nivel de ensamblado o de nivel de módulo. Por ejemplo:

  <
  Serializable()
  >
  Public Class Customer
      Public Property Name As String
      Public Property Company As String
      Public Property Email As String
  End Class
  

  Para obtener más información, consulte Información general sobre atributos.

• Antes y después de los operadores de consulta (Aggregate, Distinct, From, Group By, Group Join, Join, Let, Order By, Select, Skip, Skip While, Take, Take While, Where, In, Into, On, Ascending, y Descending). No se puede dividir una línea entre las palabras clave de los operadores de consulta que se componen de varias palabras clave (Order By, Group Join, Take Whiley Skip While). Por ejemplo:

  Dim vsProcesses = From proc In
                      Process.GetProcesses
                    Where proc.MainWindowTitle.Contains("Visual Studio")
                    Select proc.ProcessName, proc.Id,
                           proc.MainWindowTitle
  

  Para obtener más información, consulte Consultas.

• Detrás de la palabra clave In en una instrucción For Each. Por ejemplo:

  For Each p In
    vsProcesses
  
      Console.WriteLine("{0}" & vbTab & "{1}" & vbTab & "{2}",
        p.ProcessName,
        p.Id,
        p.MainWindowTitle)
  Next
  

  Para más información, consulte Instrucción For Each...Next.

• Detrás de la palabra clave From en un inicializador de colección. Por ejemplo:

  Dim days = New List(Of String) From
    {
     "Mo", "Tu", "We", "Th", "F", "Sa", "Su"
    }
  

  Para obtener más información, vea Inicializadores de colección.

Adición de comentarios

El código fuente no siempre se explica por sí mismo, incluso para el programador que lo escribió. Para ayudar a documentar su código, por lo tanto, la mayoría de los programadores hacen uso liberal de los comentarios insertados. Los comentarios en el código pueden explicar un procedimiento o una instrucción determinada a cualquier persona que lea o trabaje con él más adelante. Visual Basic omite los comentarios durante la compilación y no afectan al código compilado.

Las líneas de comentario comienzan con un apóstrofo (') o REM seguidos de un espacio. Se pueden agregar en cualquier parte del código, excepto dentro de una cadena. Para anexar un comentario a una instrucción, inserte un apóstrofo o REM después de la instrucción, seguido del comentario. Los comentarios también pueden ir en su propia línea aparte. En el ejemplo siguiente se muestran estas posibilidades.

' This is a comment on a separate code line.
REM This is another comment on a separate code line.
x += a(i) * b(i) ' Add this amount to total.
MsgBox(statusMessage) REM Inform operator of status.

Comprobación de errores de compilación

Si, después de escribir una línea de código, la línea se muestra con un subrayado azul ondulado (también puede aparecer un mensaje de error), hay un error de sintaxis en la instrucción . Debe averiguar lo que está mal (buscar en la lista de tareas o mantener el puntero del mouse sobre el error y leer el mensaje de error) y corregirlo. Hasta que haya corregido todos los errores de sintaxis en el código, el programa no se compilará correctamente.

Secciones relacionadas

Término	Definición
operadores de asignación de	Proporciona vínculos a páginas de referencia de lenguaje que abarcan operadores de asignación como =, *=y &=.
Operadores y expresiones	Muestra cómo combinar elementos con operadores para producir nuevos valores.
Cómo: Interrumpir y combinar instrucciones en código	Muestra cómo dividir una sola instrucción en varias líneas y cómo colocar varias instrucciones en la misma línea.
Procedimiento: Instrucciones de etiquetas	Muestra cómo etiquetar una línea de código.