End (Instrucción)

Artículo
10/07/2008

Actualización: noviembre 2007

Finaliza la ejecución inmediatamente.

End

Comentarios

Puede colocar la instrucción End en cualquier lugar de un procedimiento para forzar que se detenga la ejecución de toda la aplicación. End cierra los archivos abiertos mediante una instrucción Open y borra todas las variables de la aplicación. La aplicación se cierra en cuanto no detecte otros programas que mantengan referencias a sus objetos y no haya código en ejecución.

Nota:
La instrucción End detiene repentinamente la ejecución de código, sin invocar el método Dispose o Finalize, o ningún otro código de Visual Basic. Se invalidan las referencias de objetos mantenidas por otros programas. Si una instrucción End se encuentra dentro de un bloque Try o Catch, el control no pasa al bloque Finally correspondiente.

La instrucción Stop suspende la ejecución, pero a diferencia de End no cierra ningún archivo ni borra variables, a menos que se encuentre en un archivo ejecutable compilado (.exe).

Dado que End finaliza su aplicación sin tener en cuenta los recursos que podrían estar abiertos, debería intentar cerrar limpiamente antes de utilizarlo. Por ejemplo, si su aplicación tiene formularios abiertos, debería cerrarlos antes de que el control llegue a la instrucción End.

Debería utilizar End moderadamente, y sólo cuando sea necesario detener la ejecución inmediatamente. Las formas normales de terminar un procedimiento (Instrucción Return (Visual Basic) y Instrucción Exit (Visual Basic)) no sólo cierran el procedimiento limpiamente, sino que también dan al código que lo llamó la oportunidad de cerrarse limpiamente. Por ejemplo, una aplicación de consola puede sencillamente volver (Return) del procedimiento Main.

Nota de seguridad:
La instrucción End llama al método Exit de la clase Environment en el espacio de nombres System. Exit requiere que tenga permiso UnmanagedCode. De lo contrario, se genera un error SecurityException.

Cuando va seguido por una palabra clave adicional, End (Visual Basic) indica el final de la definición del procedimiento o bloque correspondientes. Por ejemplo, End Function finaliza la definición de un procedimiento Function.

Ejemplo

El ejemplo siguiente utiliza la instrucción End para terminar la ejecución del código si el usuario lo solicita.

Sub Form_Load()
  Dim answer As MsgBoxResult
  answer = MsgBox("Do you want to quit now?", MsgBoxStyle.YesNo)
  If answer = MsgBoxResult.Yes Then
      MsgBox("Terminating program")
      End
  End If
End Sub