Tutorial: Creación de una aplicación de consola de C# sencilla en Visual Studio (parte 1 de 2)

En este tutorial, usa Visual Studio para crear y ejecutar una aplicación de consola de C# y explorar algunas características del entorno de desarrollo integrado (IDE) de Visual Studio. Este tutorial es la primera parte de una serie de tutoriales de dos partes.

En este tutorial, hizo lo siguiente:

En la parte 2, ampliará esta aplicación para agregar más proyectos, aprender trucos de depuración y hacer referencia a paquetes de terceros.

Prerrequisitos

Debe tener instalado Visual Studio.

Crear un proyecto

Para empezar, cree un proyecto de aplicación de C#. En el tipo de proyecto se incluyen todos los archivos de plantilla que necesita.

Creación de la aplicación

En esta sección:

• Explora algunos cálculos de enteros básicos en C#.
• Agrega código para crear una aplicación de calculadora básica.
• Depura la aplicación para buscar y corregir errores.
• Perfecciona el código para que sea más eficaz.

Análisis de las operaciones matemáticas con enteros

Empiece con algunos cálculos básicos de enteros en C#.

Incorporación de código para crear una calculadora

Proceda a agregar al proyecto un conjunto más complejo de código de la calculadora.

1. En el editor de código, reemplace todo el código de program.cs por el siguiente código nuevo:

   using System;
   
   namespace Calculator
   {
       class Program
       {
           static void Main(string[] args)
           {
               // Declare variables and then initialize to zero.
               int num1 = 0; int num2 = 0;
   
               // Display title as the C# console calculator app.
               Console.WriteLine("Console Calculator in C#\r");
               Console.WriteLine("------------------------\n");
   
               // Ask the user to type the first number.
               Console.WriteLine("Type a number, and then press Enter");
               num1 = Convert.ToInt32(Console.ReadLine());
   
               // Ask the user to type the second number.
               Console.WriteLine("Type another number, and then press Enter");
               num2 = Convert.ToInt32(Console.ReadLine());
   
               // Ask the user to choose an option.
               Console.WriteLine("Choose an option from the following list:");
               Console.WriteLine("\ta - Add");
               Console.WriteLine("\ts - Subtract");
               Console.WriteLine("\tm - Multiply");
               Console.WriteLine("\td - Divide");
               Console.Write("Your option? ");
   
               // Use a switch statement to do the math.
               switch (Console.ReadLine())
               {
                   case "a":
                       Console.WriteLine($"Your result: {num1} + {num2} = " + (num1 + num2));
                       break;
                   case "s":
                       Console.WriteLine($"Your result: {num1} - {num2} = " + (num1 - num2));
                       break;
                   case "m":
                       Console.WriteLine($"Your result: {num1} * {num2} = " + (num1 * num2));
                       break;
                   case "d":
                       Console.WriteLine($"Your result: {num1} / {num2} = " + (num1 / num2));
                       break;
               }
               // Wait for the user to respond before closing.
               Console.Write("Press any key to close the Calculator console app...");
               Console.ReadKey();
           }
       }
   }
   

2. Seleccione el botón Calculator o presione F5 para ejecutar la aplicación.

   Se abre una ventana de consola.

3. En la ventana de consola, siga las indicaciones para agregar los números 42 y 119 juntos.

   La ventana de consola debe ser similar a la de la siguiente captura de pantalla:

   

Adición de funcionalidad decimal

Ahora, retoque el código para agregarle más funcionalidad.

La aplicación Calculator actual acepta y devuelve números enteros. Por ejemplo, si ejecuta la aplicación y divide el número 42 entre el número 119, el resultado es cero, lo cual no es correcto.

Para corregir el código a fin de mejorar la precisión mediante el control de decimales:

1. En program.cs en el editor de Visual Studio, presione Ctrl+H para abrir el control Buscar y reemplazar.

2. Escriba int en el control y escriba float en el campo Reemplazar.

3. Seleccione los iconos de Coincidir mayúsculas y minúsculas y Solo palabras completas en el control, o presione Alt+C y Alt+W.

4. Seleccione el icono Reemplazar todo o presione Alt+A para ejecutar la búsqueda y reemplazar.

   

5. Vuelva a ejecutar la aplicación Calculator y divida el número 42 entre el número 119.

   Ahora la aplicación devuelve un número decimal en lugar de cero.

   

Ahora la aplicación puede generar resultados decimales. Haga algunos retoques más en el código para que la aplicación calcule decimales también.

1. Use el control Buscar y reemplazar para cambiar cada instancia de la variable float a double y cambiar cada instancia del método Convert.ToInt32 a Convert.ToDouble.

2. Ejecute la aplicación Calculator y divida el número 42.5 entre el número 119.75.

   Ahora la aplicación acepta valores decimales y devuelve un número decimal más largo como resultado.

   

   En la sección Revisar el código, reduce el número de posiciones decimales en los resultados.

Depurar la aplicación

Ha mejorado la aplicación de calculadora básica, pero la aplicación aún no controla las excepciones, como los errores de entrada del usuario. Por ejemplo, si los usuarios intentan dividir entre cero o escribir un carácter inesperado, es posible que la aplicación deje de funcionar, devuelva un error o devuelva un resultado no numérico inesperado.

Vamos a ver algunos errores comunes de entrada de usuario, a localizarlos en el depurador si aparecen allí y a corregirlos en el código.

Corregir el error "división entre cero"

Al intentar dividir un número entre cero, es posible que la aplicación de consola se inmovilice y, luego, muestre el problema en el editor de código.

Para cambiar el código para controlar este error:

1. En program.cs, reemplace el código entre case "d": y el comentario que dice // Wait for the user to respond before closing por el código siguiente:

            // Ask the user to enter a non-zero divisor until they do so.
                while (num2 == 0)
                {
                    Console.WriteLine("Enter a non-zero divisor: ");
                    num2 = Convert.ToInt32(Console.ReadLine());
                }
                Console.WriteLine($"Your result: {num1} / {num2} = " + (num1 / num2));
                break;
        }
   

   Después de reemplazar el código, la sección con la instrucción switch debe ser similar a la de la siguiente captura de pantalla:

   

Ahora, al dividir cualquier número entre cero, la aplicación pide otro número y sigue pidiendo hasta que proporciona un número distinto de cero.

Corregir el error de "formato"

Si escribe un carácter alfabético cuando la aplicación espera un carácter numérico, la aplicación se inmoviliza. Visual Studio señala qué es incorrecto en el editor de código.

Para evitar esta excepción, puede refactorizar el código que ha especificado anteriormente.

Revisar el código

En lugar de usar la clase program para controlar todo el código, puede dividir su aplicación en dos clases: Calculator y Program.

La clase Calculator controla la mayor parte del trabajo de cálculo, mientras que la clase Program controla la interfaz de usuario y el trabajo de captura de errores.

Comencemos.

1. En program.cs, elimine todo en el espacio de nombres Calculator entre las llaves de apertura y cierre:

   using System;
   
   namespace Calculator
   {
   
   }
   

2. Entre las llaves, agregue la siguiente clase Calculator nueva:

   class Calculator
   {
       public static double DoOperation(double num1, double num2, string op)
       {
           double result = double.NaN; // Default value is "not-a-number" if an operation, such as division, could result in an error.
   
           // Use a switch statement to do the math.
           switch (op)
           {
               case "a":
                   result = num1 + num2;
                   break;
               case "s":
                   result = num1 - num2;
                   break;
               case "m":
                   result = num1 * num2;
                   break;
               case "d":
                   // Ask the user to enter a non-zero divisor.
                   if (num2 != 0)
                   {
                       result = num1 / num2;
                   }
                   break;
               // Return text for an incorrect option entry.
               default:
                   break;
           }
           return result;
       }
   }
   
   

3. Agregue también una nueva clase Program, como se indica a continuación:

   class Program
   {
       static void Main(string[] args)
       {
           bool endApp = false;
           // Display title as the C# console calculator app.
           Console.WriteLine("Console Calculator in C#\r");
           Console.WriteLine("------------------------\n");
   
           while (!endApp)
           {
               // Declare variables and set to empty.
               string numInput1 = "";
               string numInput2 = "";
               double result = 0;
   
               // Ask the user to type the first number.
               Console.Write("Type a number, and then press Enter: ");
               numInput1 = Console.ReadLine();
   
               double cleanNum1 = 0;
               while (!double.TryParse(numInput1, out cleanNum1))
               {
                   Console.Write("This is not valid input. Please enter an integer value: ");
                   numInput1 = Console.ReadLine();
               }
   
               // Ask the user to type the second number.
               Console.Write("Type another number, and then press Enter: ");
               numInput2 = Console.ReadLine();
   
               double cleanNum2 = 0;
               while (!double.TryParse(numInput2, out cleanNum2))
               {
                   Console.Write("This is not valid input. Please enter an integer value: ");
                   numInput2 = Console.ReadLine();
               }
   
               // Ask the user to choose an operator.
               Console.WriteLine("Choose an operator from the following list:");
               Console.WriteLine("\ta - Add");
               Console.WriteLine("\ts - Subtract");
               Console.WriteLine("\tm - Multiply");
               Console.WriteLine("\td - Divide");
               Console.Write("Your option? ");
   
               string op = Console.ReadLine();
   
               try
               {
                   result = Calculator.DoOperation(cleanNum1, cleanNum2, op);
                   if (double.IsNaN(result))
                   {
                       Console.WriteLine("This operation will result in a mathematical error.\n");
                   }
                   else Console.WriteLine("Your result: {0:0.##}\n", result);
               }
               catch (Exception e)
               {
                   Console.WriteLine("Oh no! An exception occurred trying to do the math.\n - Details: " + e.Message);
               }
   
               Console.WriteLine("------------------------\n");
   
               // Wait for the user to respond before closing.
               Console.Write("Press 'n' and Enter to close the app, or press any other key and Enter to continue: ");
               if (Console.ReadLine() == "n") endApp = true;
   
               Console.WriteLine("\n"); // Friendly linespacing.
           }
           return;
       }
   }
   

4. Seleccione el botón Calculator o presione F5 para ejecutar la aplicación.

5. Siga las indicaciones y divida el número 42 entre el número 119. Los resultados deben presentar un aspecto similar al de la captura de pantalla siguiente:

   

   

   Ahora puede escribir más ecuaciones hasta que decida cerrar la aplicación de consola. También hay menos posiciones decimales en los resultados. Y si escribe un carácter incorrecto, obtendrá una respuesta de error adecuada.

Cierre la aplicación

1. Si aún no lo ha hecho, cierre la aplicación de calculadora.

2. Cierre el panel Salida en Visual Studio.

   

3. En Visual Studio, presione Ctrl+G para guardar la aplicación.

Revisión: código completado

En este tutorial, ha realizado muchos cambios en la aplicación de calculadora. Ahora la aplicación controla los recursos de cálculo más eficazmente y trata la mayoría de los errores de entrada de usuario.

Este es el código completo:

using System;

namespace Calculator
{
    class Calculator
    {
        public static double DoOperation(double num1, double num2, string op)
        {
            double result = double.NaN; // Default value is "not-a-number" which we use if an operation, such as division, could result in an error.

            // Use a switch statement to do the math.
            switch (op)
            {
                case "a":
                    result = num1 + num2;
                    break;
                case "s":
                    result = num1 - num2;
                    break;
                case "m":
                    result = num1 * num2;
                    break;
                case "d":
                    // Ask the user to enter a non-zero divisor.
                    if (num2 != 0)
                    {
                        result = num1 / num2;
                    }
                    break;
                // Return text for an incorrect option entry.
                default:
                    break;
            }
            return result;
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            bool endApp = false;
            // Display title as the C# console calculator app.
            Console.WriteLine("Console Calculator in C#\r");
            Console.WriteLine("------------------------\n");

            while (!endApp)
            {
                // Declare variables and set to empty.
                string numInput1 = "";
                string numInput2 = "";
                double result = 0;

                // Ask the user to type the first number.
                Console.Write("Type a number, and then press Enter: ");
                numInput1 = Console.ReadLine();

                double cleanNum1 = 0;
                while (!double.TryParse(numInput1, out cleanNum1))
                {
                    Console.Write("This is not valid input. Please enter an integer value: ");
                    numInput1 = Console.ReadLine();
                }

                // Ask the user to type the second number.
                Console.Write("Type another number, and then press Enter: ");
                numInput2 = Console.ReadLine();

                double cleanNum2 = 0;
                while (!double.TryParse(numInput2, out cleanNum2))
                {
                    Console.Write("This is not valid input. Please enter an integer value: ");
                    numInput2 = Console.ReadLine();
                }

                // Ask the user to choose an operator.
                Console.WriteLine("Choose an operator from the following list:");
                Console.WriteLine("\ta - Add");
                Console.WriteLine("\ts - Subtract");
                Console.WriteLine("\tm - Multiply");
                Console.WriteLine("\td - Divide");
                Console.Write("Your option? ");

                string op = Console.ReadLine();

                try
                {
                    result = Calculator.DoOperation(cleanNum1, cleanNum2, op);
                    if (double.IsNaN(result))
                    {
                        Console.WriteLine("This operation will result in a mathematical error.\n");
                    }
                    else Console.WriteLine("Your result: {0:0.##}\n", result);
                }
                catch (Exception e)
                {
                    Console.WriteLine("Oh no! An exception occurred trying to do the math.\n - Details: " + e.Message);
                }

                Console.WriteLine("------------------------\n");

                // Wait for the user to respond before closing.
                Console.Write("Press 'n' and Enter to close the app, or press any other key and Enter to continue: ");
                if (Console.ReadLine() == "n") endApp = true;

                Console.WriteLine("\n"); // Friendly linespacing.
            }
            return;
        }
    }
}

Pasos siguientes