1. Introducción
El PDF del documento está |AQUÍ|.
Los códigos del documento están |AQUÍ|.
Este documento es obra de Claude, la IA de Anthropic. Sigue al documento “Introducción paso a paso al framework web [NestJS]” (2026), que a su vez adaptó el documento “Introducción a ASP.NET MVC mediante ejemplos” (2013) al framework [NestJS]. Este documento recorre el camino inverso y regresa a la plataforma [.NET], en su versión actual:
- el framework [NestJS] y el lenguaje [TypeScript] se sustituyen por el framework [ASP.NET Core MVC] y el lenguaje [C#];
- las vistas [Handlebars] se sustituyen por vistas [Razor];
- el ORM [TypeORM] se sustituye por el ORM [Entity Framework Core], siempre sobre [MySQL].
El documento sigue de cerca la progresión del curso de [NestJS]: primero, numerosos proyectos pequeños, cada uno centrado en un solo concepto, y luego un caso de estudio completo —una aplicación web para la gestión de citas en un consultorio médico— con todos los archivos comentados en detalle. Los ejemplos tienen los mismos números y tratan los mismos temas que en el curso de [NestJS]: un lector que conozca ese curso puede comparar los dos frameworks ejemplo por ejemplo. Sin embargo, esto no es necesario: este documento se basta a sí mismo y no supone ningún conocimiento previo de [NestJS] ni, para el caso, de [ASP.NET]. Los únicos requisitos previos son una comprensión básica de la programación web (el protocolo HTTP, el lenguaje HTML) y el lenguaje [C#].
1.1. El papel de ASP.NET Core MVC en una aplicación web
Una aplicación web suele construirse en capas, y cada capa se comunica solo con las capas vecinas:

- la capa web recibe las solicitudes HTTP del navegador y le devuelve páginas HTML. Es la capa que [ASP.NET Core MVC] nos ayuda a escribir;
- La capa de negocio contiene las reglas de negocio de la aplicación (por ejemplo, “un paciente solo puede tener una cita próxima”). No sabe nada de la web: podría servir igualmente a una aplicación de línea de comandos;
- La capa de acceso a datos (capa [DAO], por [Data Access Object]) lee y escribe en la base de datos. Usaremos el ORM [Entity Framework Core] ([Object Relational Mapper]), que establece la correspondencia entre las filas de las tablas y los objetos en [C#].
La propia capa web sigue el modelo [MVC] ([Model – View – Controller]):
- el controlador (C) es una clase cuyos métodos —llamados acciones— se encargan cada uno de un tipo específico de solicitud (por ejemplo, [GET /schedule]). Una acción lee los parámetros de la solicitud, invoca la capa de negocio y luego elige la vista que se mostrará;
- el modelo (M) es el conjunto de datos que la acción pasa a la vista: un objeto [C#];
- la vista (V) es un archivo [Razor] (extensión [.cshtml]): a partir de HTML, en el que las expresiones [C#] —precedidas por el carácter [@]— se reemplazan por datos del modelo.
El procesamiento de una solicitud sigue los pasos numerados del diagrama:
- 1: El navegador envía una solicitud HTTP, por ejemplo, [GET /schedule?doctorId=1&day=2026-09-24];
- 2: El servidor web [Kestrel], integrado con [ASP.NET Core], recibe la solicitud. Esta pasa por una serie de componentes de middleware (lectura de cookies, autenticación, archivos estáticos, etc.) y luego [ASP.NET Core] selecciona la acción encargada de procesar esta solicitud: esto es el enrutamiento. Antes de llegar a la acción, la solicitud aún puede pasar por filtros, que exploraremos en capítulos posteriores;
- 3: La acción solicita a la capa de negocio los datos que necesita;
- 4: Construye el modelo de la vista y designa la vista que debe mostrarlo;
- 5: El motor de vistas [Razor] genera la página HTML, que [ASP.NET Core] devuelve al navegador.
[ASP.NET Core] es el framework web de la plataforma [.NET] de Microsoft. Gratuito y de código abierto, se ejecuta en [Windows], [Linux], y [macOS]. Permite crear servidores que devuelven JSON a un cliente [JavaScript] ([Angular], [React], [Flutter]...) así como aplicaciones web tradicionales, en las que el servidor genera las páginas HTML y el navegador se limita a mostrarlas. Es este segundo caso de uso —la parte MVC del framework— el que estudia este documento. Al igual que [NestJS], que se inspiró mucho en él, [ASP.NET Core] se basa en dos ideas: los atributos ([[HttpGet]], [[Route]], [[Authorize]]...) describen los roles de las clases y los métodos, y la inyección de dependencias proporciona a cada objeto las dependencias que necesita.
1.2. Herramientas utilizadas
Los ejemplos se escribieron y probaron con las siguientes herramientas (su instalación se describe en el apéndice):
- el SDK de [.NET] 10 ([Software Development Kit]), que contiene el compilador de [C#], el framework [ASP.NET Core] y la herramienta de línea de comandos [dotnet]. [.NET] 10 es la versión LTS (Long-Term Support) actual;
- el editor [Visual Studio Code], con la extensión [C# Dev Kit];
- un navegador reciente ([Chrome], [Firefox], [Edge]);
- la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar (viene incluida con [Windows] 10 y 11);
- el SGBD [MySQL] (o [MariaDB]), por ejemplo, el de [Laragon] en [Windows], a partir del capítulo sobre el acceso a datos y para el caso de estudio.
El framework [ASP.NET Core] forma parte del SDK: los ejemplos no requieren ninguna biblioteca adicional hasta el capítulo 8. Los ejemplos 25 a 28 y el caso de estudio usan tres bibliotecas, que se descargan automáticamente del sitio [nuget.org] durante su primera compilación (por lo que ese día debe estar conectado a Internet): [Microsoft.AspNetCore.Authentication.JwtBearer] (tokens JWT), [BCrypt.Net-Next] (hashes de contraseñas) y [Pomelo.EntityFrameworkCore.MySql] ([Entity Framework Core] para [MySQL]).
1.3. Ejecutar el caso de estudio
Nota del revisor: Aconsejo al lector que realice el caso de estudio de inmediato, como se describe a continuación. Una vez que haya comprendido bien el papel de esta aplicación de gestión de citas, pida a su IA favorita que modifique la aplicación de la siguiente manera: a partir de ahora, cada médico podrá:
- definir sus propios horarios de citas entre dos fechas. Esto les permitirá ajustar su agenda según sus necesidades;
- quitar ciertos horarios del calendario en un día determinado —por ejemplo, si no están disponibles por motivos personales;
La modificación no es trivial, porque implica un cambio en la estructura de la base de datos. Pida a la IA que le entregue el nuevo código de la aplicación y el script SQL para crear la nueva base de datos. Para ello, deberá proporcionarle el archivo ZIP con el proyecto completo, así como el script SQL de la base de datos anterior.
Además, no he revisado el curso creado por Claude. Él ya había producido un curso de [NestJS] perfecto. Supuse que lo mismo ocurriría con este. Si tiene algún problema para entender algo, la solución es siempre la misma: pida a su IA favorita que le explique lo que no entiende. Claude, por ejemplo, es muy bueno para esto. Quizá deba “subirle” el ejemplo que no entiende.
Fin de la nota.
El caso de estudio al final de este documento es una aplicación completa. Es probable que los lectores quieran verla en funcionamiento antes de entrar en los detalles del framework: a continuación se explica cómo ejecutarla. Se encuentra en la carpeta [rdvmedecins2-aspnetcore-mvc], junto a la carpeta [examples]:
Debe tener instalados el SDK de [.NET] 10, [Visual Studio Code] y [MySQL] (consulte los apéndices). Luego:
- Cree la base de datos [dbrdvmedecins2] ejecutando el script [rdvmedecins2-aspnetcore-mvc/database/dbrdvmedecins2.sql]. Con [Laragon], abra la herramienta [HeidiSQL] (botón Base de datos) y luego ejecute el script desde el menú Archivo / Ejecutar SQL. En la línea de comandos:
- Verifique la conexión a la base de datos. La aplicación se conecta a [MySQL] en [localhost], puerto 3306, con el usuario [root] sin contraseña (la configuración predeterminada de [Laragon]). Si su cuenta [root] tiene contraseña, introdúzcala en el archivo [appsettings.json] de la aplicación, al final de la cadena de conexión [ConnectionStrings:RdvMedecins] ([...;User=root;Password=myPassword;]). Para [MariaDB], indique también su versión en la clave [MySql:ServerVersion] (por ejemplo, [10.11.0-mariadb]);
- Abra la carpeta [rdvmedecins2-aspnetcore-mvc] en [Visual Studio Code] (menú Archivo / Abrir carpeta) y luego abra una terminal (menú Terminal / Nueva terminal);
- Inicie la aplicación:
- En la primera ejecución, [dotnet] descarga las bibliotecas de [nuget.org], compila la aplicación y luego la inicia. La consola muestra entonces la dirección de la aplicación:
- Abra la dirección [http://localhost:8081] en un navegador:

- Inicie sesión con una de las cuentas de demostración, cuya contraseña es igual al nombre de usuario: [admin] (administrador), [pelissier], [tatou], [dupont] (médicos), [martin], [durand], [bistrou], [german] (pacientes). También debe introducir los caracteres de la imagen, en mayúsculas o minúsculas.
Si la aplicación se cierra de inmediato con el mensaje [Unable to connect to any of the specified MySQL hosts], significa que [MySQL] no se ha iniciado; con [Access denied for user 'root'@'localhost'], la contraseña de la cadena de conexión es incorrecta; con [Unknown database 'dbrdvmedecins2'], no se ha ejecutado el script SQL. El archivo [README.md] de la aplicación describe otros escenarios. La aplicación se detiene con [Ctrl-C] en la terminal.
El último capítulo del documento explica cómo usar la aplicación y luego analiza cada uno de sus archivos.
1.4. Ejemplos
Los ejemplos se encuentran en la carpeta [examples], con una subcarpeta por ejemplo:
Cada ejemplo es un proyecto [.NET] independiente que se puede compilar y ejecutar por sí solo. El archivo [examples.slnx] es una solución: una lista de todos estos proyectos. Cuando abre la carpeta [examples] en [Visual Studio Code], la extensión [C# Dev Kit] encuentra la solución y carga todos los proyectos (panel Explorador de soluciones): así dispone de resaltado de sintaxis, autocompletado e informes de errores en cada archivo.
La carpeta [common/bootstrap] contiene los CSS y los frameworks [Bootstrap], compartidos por los ejemplos que dan formato a sus páginas (a partir del ejemplo 15).
Cada ejemplo tiene la estructura de un proyecto [ASP.NET Core MVC]:
- [Program.cs]: el punto de entrada de la aplicación —configuración, servicios e inicio del servidor;
- [Controllers]: los controladores;
- [Models]: las clases que describen los modelos (de las acciones y de las vistas);
- [Views]: las vistas [Razor] (a partir del capítulo 4);
- [appsettings.json]: la configuración de la aplicación (niveles de registro y, más adelante, conexión a la base de datos, etc.);
- [Example13.csproj]: el archivo del proyecto, que describe cómo compilar la aplicación.
Para ejecutar un ejemplo, abra una terminal en su carpeta (en [Visual Studio Code]: haga clic con el botón derecho en la carpeta del ejemplo y luego seleccione “Abrir en la terminal integrada”) y escriba:
[dotnet run] compila el proyecto (en su carpeta [bin]), y luego ejecuta la aplicación. Con [dotnet watch], el código se recompila y la aplicación se reinicia cada vez que se modifica un archivo [.cs] o [.cshtml]:
Todos los ejemplos escuchan en el puerto 5000, el puerto predeterminado de [ASP.NET Core]: solo uno puede estar en ejecución a la vez. Detenga el servidor con [Ctrl-C] en la terminal. También puede compilar todos los ejemplos a la vez desde la carpeta [examples] para verificar que la instalación esté completa:
El archivo de proyecto de un ejemplo se reduce a una sola línea. Por ejemplo, [01-structure/Example01.csproj]:
- Línea 1: [Microsoft.NET.Sdk.Web] es el SDK para aplicaciones web. Por sí solo proporciona todo el framework [ASP.NET Core]: controladores, vistas, configuración, servidor web...
Los ajustes comunes a todos los ejemplos se escriben una sola vez, en el archivo [examples/Directory.Build.props], que el compilador lee automáticamente para cualquier proyecto ubicado en la carpeta [examples]:
Veamos este archivo:
- línea 9: la versión objetivo de [.NET]: [.NET] 10;
- línea 11: los tipos de referencia “anulables” (nullable). El compilador distingue entre una variable de tipo [string], a la que nunca se debe asignar el valor [null], y una variable de tipo [string?], a la que sí se le puede asignar ese valor, y emite una advertencia ante cualquier posible error que involucre [NullReferenceException];
- Línea 13: Los espacios de nombres más comunes ([System], [System.Linq], [System.Threading.Tasks], [Microsoft.AspNetCore.Builder]...) se importan automáticamente en cada archivo: no es necesario escribir las directivas [using] correspondientes.
Por último, el archivo [appsettings.json] es el mismo para todos los ejemplos hasta el capítulo 8:
- Líneas 4–5: niveles de registro. Los mensajes de la aplicación se muestran a partir del nivel [Information]; los de [ASP.NET Core] mismo —que son muy numerosos— se muestran solo a partir del nivel [Warning]. Así, la consola mostrará los mensajes de inicio y los errores, pero no los detalles de cada solicitud;
- Línea 8: los nombres de dominio aceptados en las solicitudes ([*]: todos).
1.5. Contenido del documento
El documento está organizado de la siguiente manera:
Capítulo | Contenido | Ejemplos |
Controladores, acciones, | Del navegador a la acción: rutas, respuestas, redirecciones, servicios | 01 a 06 |
El modelo de la acción | Parámetros de la solicitud: enlace, conversión, validación, formularios POST | 07 a 12 |
La vista y su modelo | Razor, modelo, vistas parciales, helpers, formularios, validación, PRG | 13 a 21 |
Internacionalización | Una aplicación en francés y en inglés | 22 |
Ámbitos de datos | aplicación, consulta, cliente | 23 |
El ciclo de vida de una solicitud | middleware, filtros de autorización, filtros de acción, filtros de excepciones, enlace de modelos | 24 |
Autenticación y autorización | JWT en una cookie, roles, CAPTCHA, límite de intentos | 25–27 |
Arquitectura en capas | Web / Negocio / DAO con Entity Framework Core y MySQL | 28 |
Caso de estudio | La aplicación RdvMedecins, explicada archivo por archivo | - |
Cada ejemplo introduce solo unos pocos conceptos nuevos, y los capítulos se apoyan unos en otros: lo mejor es leerlos en orden. El caso de estudio, por su parte, recurre a todos los conceptos de los capítulos anteriores: siempre que corresponde, su comentario remite al ejemplo donde se introdujo el concepto.