Ejecuta de forma condicional un grupo de instrucciones, según el valor de una expresión.

If condición Then instrucciones [Else instruccioneselse ]

O bien, puede utilizar la sintaxis de forma de bloque:

If condición Then 
    [instrucciones] 
[Else condición-n Then
  [instruccioneselseif]] . . .
[Else 
    [instruccioneselse]]
End If

Argumentos

condición

Uno o varios de los siguientes tipos de expresiones:

Una expresión numérica o de cadena que se evalúa como True o False. Si la condición es Null, la condición se trata como False.

Una expresión de la forma TypeOf nombreobjeto Is tipoobjeto. El nombreobjeto es cualquier referencia de objeto y tipoobjeto es cualquier tipo de objeto válido. La expresión es True si nombreobjeto es del tipo de objeto especificado por tipoobjeto y si no es así, es False.

instrucciones

Una o varias instrucciones separadas por dos puntos. Se ejecuta si la condición es True.

condición-n

Igual que condición.

instruccioneselseif

Una o varias instrucciones ejecutadas si la condición-n asociada es True.

instruccioneselse

Una o varias instrucciones ejecutadas si ninguna expresión de condición o condición-n previa es True.

Comentarios

Puede utilizar la forma de línea única (primera sintaxis) para pruebas cortas y simples. Sin embargo, la forma de bloque (segunda sintaxis) proporciona una mejor estructura y flexibilidad que la forma de línea única y es normalmente más fácil de leer, mantener y depurar.

Nota   Con la sintaxis de línea única, es posible hacer que se ejecuten varias instrucciones como resultado de una decisión If...Then, pero deben estar todas en la misma línea y separadas por dos puntos, como en la siguiente instrucción:

If A > 10 Then A = A + 1 : B = B + A : C = C + B

Cuando se ejecuta un bloque If (segunda sintaxis), se prueba la condición. Si la condición es True, se ejecutan las instrucciones que siguen a Then. Si la condición es False, se evalúa cada ElseIf (si hubiera) por turno. Cuando se encuentra una condición True, se ejecutan las instrucciones que siguen a la instrucción Then asociada. Si ninguna de las instrucciones ElseIf son True (o no existen claúsulas ElseIf), se ejecutan las instrucciones que siguen a Else. Después de ejecutar las instrucciones que siguen a Then o Else, la ejecución continúa con la instrucción que sigue a End If.

Las claúsulas Else y ElseIf son opcionales. Puede tener tantas instrucciones ElseIf como desee en un bloque If, pero ninguna puede aparecer después de la claúsula Else. Las instrucciones de bloque If se pueden anidar; es decir, estar contenidas una dentro de otra.

Lo que sigue a la palabra clave Then se examina para determinar si una instrucción es un bloque If o no. Si aparece cualquier otra cosa que no sea un comentario después de Then en la misma línea, la instrucción de trata como una instrucción de línea única If.

Una instrucción de bloque If debe ser la primera instrucción en una línea. El bloque If debe terminar con una instrucción End If.

Requisitos

Versión 1