IRONSOFTWAREHOME
ACTUALIZACIONES PARA DESARROLLADORES

C# Conexión MySQL (Cómo Funciona para Desarrolladores)

Jacob Mellor, Director de Tecnología @ Team Iron
Jacob Mellor
Updated: 21 de abril de 2026

Introducción a la Integración de C# con MySQL

Conectar aplicaciones C# a bases de datos MySQL permite a los desarrolladores aprovechar el poder de una base de datos relacional para almacenar, recuperar y gestionar datos de manera eficiente. Esta guía proporciona un proceso paso a paso para integrar MySQL con aplicaciones C# y demuestra cómo generar PDF desde los datos dentro de tu base de datos MySQL utilizando la biblioteca IronPDF.

Prerrequisitos

Para seguir esta guía, necesitarás:

  • Visual Studio o cualquier IDE de C#
  • Una base de datos MySQL (instalada y en funcionamiento)
  • La biblioteca IronPDF (para generación de PDF)

Cómo configurar una base de datos MySQL

Instalación y configuración de MySQL

  1. Descarga la última versión de MySQL desde mysql.com.
  2. Ejecuta el instalador y sigue las instrucciones de configuración. Selecciona "Desarrollador por defecto" para incluir el servidor MySQL y MySQL Workbench.
  3. Configura las credenciales del usuario root de MySQL durante la configuración y asegúrate de que el servicio MySQL esté en funcionamiento.

Creación de una base de datos y tablas de ejemplo

  1. Abre MySQL Workbench y conecta al servidor.
  2. Crea una nueva base de datos y una tabla de muestra usando comandos SQL:
CREATE DATABASE SampleDB;
USE SampleDB;
CREATE TABLE Employees (
    EmployeeID INT PRIMARY KEY AUTO_INCREMENT,
    FirstName VARCHAR(50),
    LastName VARCHAR(50),
    Position VARCHAR(50),
    Salary DECIMAL(10, 2)
);
Text
  1. Inserta datos de muestra:
INSERT INTO Employees (FirstName, LastName, Position, Salary) 
VALUES ('John', 'Doe', 'Software Developer', 80000),
       ('Jane', 'Smith', 'Data Analyst', 75000);
Text

Cómo configurar un usuario MySQL para acceso remoto (opcional)

Para acceso remoto, crea un usuario MySQL con los permisos necesarios:

CREATE USER 'remoteUser'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON SampleDB.* TO 'remoteUser'@'%';
FLUSH PRIVILEGES;
Text

Conectando C# a la Base de Datos MySQL

Instalación de la Biblioteca MySql.Data en C#

Para conectar aplicaciones C# a MySQL, utilizamos la biblioteca MySQL Connector/NET (a menudo llamada Connector/NET). Este es el controlador oficial .NET para MySQL, que se puede instalar a través de NuGet.

  1. Abre Visual Studio y crea una nueva aplicación de consola C#.
  2. Agrega la biblioteca MySql.Data a través del Administrador de paquetes NuGet:
    • Haz clic derecho en el proyecto > Administrar paquetes NuGet > Buscar > busca MySql.Data e instálalo.

Escribir el código de conexión

El siguiente ejemplo de código demuestra cómo establecer una conexión con MySQL:

using System;
using MySql.Data.MySqlClient;

public class Program
{
    // Connection string containing the server, database, user credentials, etc.
    private string connectionString = "Server=localhost;Database=SampleDB;User ID=root;Password=yourpassword;";
    
    private void Initialize()
    {
        // Create a MySQL connection object
        MySqlConnection connection = new MySqlConnection(connectionString);
        try
        {
            connection.Open();
            Console.WriteLine("Connected to MySQL Database!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        finally
        {
            connection.Close(); // Ensure the connection is closed after use
        }
    }
}

Explicación:

  • Cadena de conexión: contiene detalles como el servidor, el nombre de la base de datos, el ID de usuario y la contraseña.
  • MySqlConnection: Se utiliza para establecer la conexión.
  • Método Open(): intenta abrir la conexión.
  • Manejo de excepciones: captura excepciones para manejar errores de conexión con elegancia.

Uso de registros DNS SRV para la conexión (opcional)

Si tu aplicación está alojada en la nube o necesita conectarse a una base de datos MySQL a través de registros DNS SRV, puedes reemplazar el nombre del servidor con la entrada DNS correspondiente que resuelve la IP de la base de datos.

string connectionString = "Server=mysql.example.com;Database=SampleDB;User ID=root;Password=yourpassword;";

Agrupación de conexiones

Por defecto, MySQL Connector/NET soporta el agrupamiento de conexiones, lo que ayuda a manejar las conexiones a la base de datos de manera más eficiente. El agrupamiento de conexiones reduce la sobrecarga de abrir y cerrar conexiones repetidamente reutilizando conexiones existentes de un pool.

Si deseas personalizar el comportamiento del agrupamiento de conexiones, puedes ajustar tu cadena de conexión de esta manera:

string connectionString = "Server=localhost;Database=SampleDB;User ID=root;Password=yourpassword;Pooling=true;";

Manejo de errores comunes

Los problemas comunes incluyen cadenas de conexión incorrectas, restricciones de firewall o el servicio MySQL no en funcionamiento. Asegúrate de que todos los detalles de configuración sean correctos y que el servicio MySQL esté activo.

Realizando Operaciones CRUD con C# y MySQL

Creación de una Clase C# para Operaciones en Base de Datos

Para la organización del código, cree una clase DatabaseHelper para gestionar todas las operaciones de la base de datos. Esta clase contendrá métodos para Insertar, Leer, Actualizar y Borrar datos (operaciones CRUD).

using System;
using MySql.Data.MySqlClient;

public class DatabaseHelper
{
    private string connectionString = "Server=localhost;Database=SampleDB;User ID=root;Password=yourpassword;";

    // Method to insert a new employee record
    public void InsertEmployee(string firstName, string lastName, string position, decimal salary)
    {
        using (var connection = new MySqlConnection(connectionString))
        {
            string query = "INSERT INTO Employees (FirstName, LastName, Position, Salary) VALUES (@FirstName, @LastName, @Position, @Salary)";
            MySqlCommand cmd = new MySqlCommand(query, connection);

            // Add parameters to prevent SQL injection
            cmd.Parameters.AddWithValue("@FirstName", firstName);
            cmd.Parameters.AddWithValue("@LastName", lastName);
            cmd.Parameters.AddWithValue("@Position", position);
            cmd.Parameters.AddWithValue("@Salary", salary);

            connection.Open();
            cmd.ExecuteNonQuery(); // Execute the insert command
        }
    }
}

Explicación:

  • Parametrización: Usar @Parameter reduce el riesgo de inyección SQL.
  • connection.Open(): Abre la conexión MySQL.
  • cmd.ExecuteNonQuery(): ejecuta la consulta de inserción.

Insertar datos en una base de datos MySQL

Para agregar datos de nuevos empleados, llame al método InsertEmployee:

DatabaseHelper dbHelper = new DatabaseHelper();
dbHelper.InsertEmployee("Alice", "Brown", "Project Manager", 90000);

Recuperación y visualización de datos

Recupera datos y muéstralos en la consola:

public void GetEmployees()
{
    using (var connection = new MySqlConnection(connectionString))
    {
        string query = "SELECT * FROM Employees";
        MySqlCommand cmd = new MySqlCommand(query, connection);
        connection.Open();

        using (MySqlDataReader reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine($"{reader["FirstName"]} {reader["LastName"]}, Position: {reader["Position"]}, Salary: {reader["Salary"]}");
            }
        }
    }
}

Explicación:

  • ExecuteReader(): ejecuta la consulta de selección y devuelve un objeto MySqlDataReader.
  • reader.Read(): itera a través del conjunto de resultados, mostrando los detalles de cada empleado.

Actualización y eliminación de registros

Aquí hay un ejemplo para actualizar el salario de un empleado:

public void UpdateEmployeeSalary(int employeeId, decimal newSalary)
{
    using (var connection = new MySqlConnection(connectionString))
    {
        string query = "UPDATE Employees SET Salary = @Salary WHERE EmployeeID = @EmployeeID";
        MySqlCommand cmd = new MySqlCommand(query, connection);

        // Parameterize the SQL command
        cmd.Parameters.AddWithValue("@Salary", newSalary);
        cmd.Parameters.AddWithValue("@EmployeeID", employeeId);

        connection.Open();
        cmd.ExecuteNonQuery(); // Execute the update command
        Console.WriteLine("Employee salary updated successfully!");
    }
}

Comando de actualización: utiliza una consulta parametrizada para actualizar la columna Salario en función del EmployeeID.

Generación de PDF a partir de datos MySQL con IronPDF

Introducción a IronPDF

IronPDF es una biblioteca robusta que permite a los desarrolladores crear, editar y manipular documentos PDF fácilmente dentro de aplicaciones C#. Soporta una amplia gama de funcionalidades PDF, convirtiéndola en una herramienta perfecta para aplicaciones basadas en datos que requieren generación de informes automatizados, manipulación de documentos o conversión de HTML a PDF. Ya sea que necesites convertir páginas web dinámicas a archivos PDF o generar PDFs personalizados desde cero, IronPDF simplifica el proceso con unas pocas líneas de código.

Características principales de IronPDF

  • Conversión de HTML a PDF: una de las características destacadas de IronPDF es su capacidad de convertir contenido HTML en documentos PDF completamente formateados. Esta característica es particularmente útil para generar informes a partir de contenido web dinámico o cuando se trabaja con datos almacenados en un formato web.
  • Edición de PDF: IronPDF permite editar PDF existentes, lo que incluye agregar, eliminar y modificar contenido, como texto, imágenes, tablas y más. Esto es ideal para aplicaciones que necesitan procesar o actualizar documentos preexistentes.
  • Fusión y división de PDF: con IronPDF, puede fusionar fácilmente varios PDF en un solo documento o dividir un PDF grande en archivos más pequeños. Esta característica es útil para organizar y gestionar grandes colecciones de documentos.
  • Estilo y personalización: al generar archivos PDF a partir de HTML, puede usar CSS para darle estilo al documento y lograr un diseño personalizado que coincida con el diseño de su aplicación. IronPDF te da control total sobre la apariencia de tus PDFs, asegurando que cumplan con tus requisitos específicos.

Configuración de IronPDF en Tu Proyecto C#

Para usar IronPDF, instálalo a través del Gestor de Paquetes NuGet en Visual Studio:

PM > Install-Package IronPdf

Convertir datos MySQL a formato PDF

Aquí tienes el ejemplo completo de código que muestra cómo crear un informe PDF de datos de empleados:

using System;
using MySql.Data.MySqlClient;
using IronPdf;

public class Program
{
    private static string connectionString = "Server=localhost;Database=SampleDB;User ID=root;Password=yourpassword;";

    public static void Main(string[] args)
    {
        // Perform CRUD operations
        DatabaseHelper dbHelper = new DatabaseHelper();
        // Insert a new employee
        dbHelper.InsertEmployee("Alice", "Brown", "Project Manager", 90000);
        // Display employees
        dbHelper.GetEmployees();
        // Update an employee's salary
        dbHelper.UpdateEmployeeSalary(1, 95000);
        // Generate a PDF report
        dbHelper.GenerateEmployeeReportPDF();
        Console.WriteLine("Operations completed.");
    }
}

public class DatabaseHelper
{
    private string connectionString = "Server=localhost;Database=SampleDB;User ID=root;Password=yourpassword;";

    // Insert employee into database
    public void InsertEmployee(string firstName, string lastName, string position, decimal salary)
    {
        using (var connection = new MySqlConnection(connectionString))
        {
            string query = "INSERT INTO Employees (FirstName, LastName, Position, Salary) VALUES (@FirstName, @LastName, @Position, @Salary)";
            MySqlCommand cmd = new MySqlCommand(query, connection);
            cmd.Parameters.AddWithValue("@FirstName", firstName);
            cmd.Parameters.AddWithValue("@LastName", lastName);
            cmd.Parameters.AddWithValue("@Position", position);
            cmd.Parameters.AddWithValue("@Salary", salary);
            connection.Open();
            cmd.ExecuteNonQuery();
            Console.WriteLine($"Employee {firstName} {lastName} inserted successfully!");
        }
    }

    // Get employees from the database and display them
    public void GetEmployees()
    {
        using (var connection = new MySqlConnection(connectionString))
        {
            string query = "SELECT * FROM Employees";
            MySqlCommand cmd = new MySqlCommand(query, connection);
            connection.Open();

            using (MySqlDataReader reader = cmd.ExecuteReader())
            {
                Console.WriteLine("\nEmployee List:");
                while (reader.Read())
                {
                    Console.WriteLine($"{reader["EmployeeID"]} - {reader["FirstName"]} {reader["LastName"]}, Position: {reader["Position"]}, Salary: {reader["Salary"]}");
                }
            }
        }
    }

    // Update the salary of an employee
    public void UpdateEmployeeSalary(int employeeId, decimal newSalary)
    {
        using (var connection = new MySqlConnection(connectionString))
        {
            string query = "UPDATE Employees SET Salary = @Salary WHERE EmployeeID = @EmployeeID";
            MySqlCommand cmd = new MySqlCommand(query, connection);
            cmd.Parameters.AddWithValue("@Salary", newSalary);
            cmd.Parameters.AddWithValue("@EmployeeID", employeeId);
            connection.Open();
            cmd.ExecuteNonQuery();
            Console.WriteLine($"Employee ID {employeeId}'s salary updated to {newSalary}.");
        }
    }

    // Generate a PDF report of all employees
    public void GenerateEmployeeReportPDF()
    {
        string htmlContent = "<h1>Employee Report</h1><table border='1'><tr><th>EmployeeID</th><th>First Name</th><th>Last Name</th><th>Position</th><th>Salary</th></tr>";
        
        using (var connection = new MySqlConnection(connectionString))
        {
            string query = "SELECT * FROM Employees";
            MySqlCommand cmd = new MySqlCommand(query, connection);
            connection.Open();

            using (MySqlDataReader reader = cmd.ExecuteReader())
            {
                while (reader.Read())
                {
                    htmlContent += $"<tr><td>{reader["EmployeeID"]}</td><td>{reader["FirstName"]}</td><td>{reader["LastName"]}</td><td>{reader["Position"]}</td><td>{reader["Salary"]}</td></tr>";
                }
            }
        }
        
        htmlContent += "</table>";

        // Use IronPDF to convert HTML to PDF
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("EmployeeReport.pdf");
        Console.WriteLine("PDF Report generated successfully!");
    }
}

Desglose del código

  1. Conexión a la Base de Datos MySQL:

    • El connectionString define el servidor MySQL, la base de datos, el usuario y la contraseña.
    • Usted se conecta usando MySqlConnection y maneja operaciones CRUD con MySqlCommand.
  2. Operación de Inserción (InsertarEmpleado):

    • Utiliza MySqlCommand con consultas parametrizadas (@FirstName, @LastName, etc.) para prevenir la inyección SQL.
    • Después de abrir la conexión (connection.Open()), ExecuteNonQuery() ejecuta la sentencia INSERT SQL.
  3. Operación de Lectura (ObtenerEmpleados):

    • Ejecuta una consulta SELECT * para obtener todos los registros de empleados.
    • Utiliza un MySqlDataReader para iterar sobre el conjunto de resultados y mostrar cada registro en la consola.
  4. Operación de Actualización (ActualizarSalarioEmpleado):

    • El método acepta un employeeId y un newSalary para actualizar el salario del empleado.
    • Usa una consulta SQL UPDATE parametrizada.
  5. Generación de PDF (GenerarInformePDFEmpleado):

    • Recopila datos de empleados en una cadena HTML con una estructura de tabla simple.
    • El contenido HTML se pasa al método RenderHtmlAsPdf de IronPDF para generar un informe PDF.
    • El PDF resultante se guarda como EmployeeReport.pdf.

Conclusión

En este artículo, recorrimos los pasos esenciales para integrar MySQL con una aplicación C#. Desde configurar la base de datos y realizar operaciones CRUD hasta generar PDFs con IronPDF, cubrimos una amplia gama de temas fundamentales que son cruciales para construir aplicaciones basadas en datos. Aquí tienes un resumen de los conceptos principales:

  • Integración de MySQL y C#: demostramos cómo conectarse a una base de datos MySQL usando la biblioteca MySql.Data, administrar conexiones de bases de datos y realizar operaciones CRUD usando consultas parametrizadas. Esto asegura que los datos se puedan almacenar, actualizar y recuperar de manera eficiente de una forma segura y ordenada.
  • Realización de operaciones CRUD: con los métodos de ejemplo para insertar, actualizar y leer datos de empleados, puede ampliar esta lógica para administrar otros tipos de registros en una base de datos del mundo real. El uso de consultas parametrizadas también ayuda a mitigar ataques de inyección SQL, asegurando la seguridad de tu aplicación.
  • IronPDF para generación de PDF: IronPDF facilita la generación de PDF de aspecto profesional a partir de contenido HTML dinámico. Al convertir los datos recuperados de MySQL en una tabla HTML, podemos crear informes personalizados y guardarlos como PDFs, lo cual puede ser útil para generar facturas, informes, resúmenes y más. La API sencilla de IronPDF la convierte en una herramienta excelente para cualquier desarrollador C# que necesite manejar la generación de PDF dentro de sus aplicaciones.

Al combinar C# y MySQL, los desarrolladores pueden construir aplicaciones robustas que almacenen y gestionen datos mientras ofrecen funcionalidades avanzadas como la generación de informes en PDF. Estas capacidades son útiles en varias industrias, desde finanzas hasta salud, donde la gestión y generación precisa de datos son críticas.

Para los desarrolladores que buscan incorporar la generación de PDF en sus aplicaciones C#, IronPDF te permite probar el conjunto completo de características. Ya sea que necesites generar documentos simples o informes sofisticados, IronPDF puede ser una herramienta invaluable para automatizar la creación de PDF dentro de tu flujo de trabajo.

Jacob Mellor, Director de Tecnología @ Team Iron
Director de Tecnología

Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.

...
Leer más

Artículos Relacionados

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

OR
bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999