Usar Web API 2 con Entity Framework 6

  • Artículo

Descargar el proyecto completado

Este tutorial le enseña los conceptos básicos de la creación de una aplicación web con un back-end de ASP.NET Web API. El tutorial utiliza Entity Framework 6 para la capa de datos y Knockout.js para la aplicación JavaScript del lado del cliente. El tutorial también muestra cómo implementar la aplicación en App Service Web Apps.

Versiones de software usadas en el tutorial

  • Web API 2.1
  • Visual Studio 2017 (descargar Visual Studio 2017 aquí)
  • Entity Framework 6
  • .NET 4.7
  • Knockout.js 3.1

En este tutorial se usa ASP.NET Web API 2 con Entity Framework 6 para crear una aplicación web que manipule una base de datos back-end. Esta es una captura de pantalla de la aplicación que va a crear.

Screenshot of the created application window, Book Service, showing the Books, Detail, and Add Book panes.

La aplicación usa un diseño de aplicación de página única (SPA). "Aplicación de página única" es el término general para una aplicación web que carga una sola página HTML y después la actualiza dinámicamente, en lugar de cargar páginas nuevas. Después de cargar la página inicial, la aplicación se comunica con el servidor a través de solicitudes de AJAX. Las solicitudes AJAX devuelven datos JSON, que la aplicación usa para actualizar la interfaz de usuario.

AJAX no es nuevo, pero hoy en día existen marcos de JavaScript que facilitan la tarea de compilar y mantener una gran aplicación SPA sofisticada. En este tutorial se usa Knockout.js, pero puede usar cualquier marco de cliente de JavaScript.

Estos son los principales bloques de creación de esta aplicación:

  • ASP.NET MVC crea la página HTML.
  • ASP.NET Web API controla las solicitudes de AJAX y devuelve datos JSON.
  • Knockout.js enlaza los elementos HTML a los datos JSON.
  • Entity Framework se comunica con la base de datos.

Consulte esta aplicación que se ejecuta en Azure

¿Desea ver que el sitio terminado se ejecuta como una aplicación web activa? Para implementar una versión completa de la aplicación en su cuenta de Azure, seleccione el botón siguiente.

Necesita una cuenta de Azure para implementar esta solución en Azure. Si aún no tiene una cuenta, tiene las siguientes opciones:

Creación del proyecto

Abierto Visual Studio. En el menú Archivo, seleccione Nuevo y, a continuación, seleccione Proyecto. (O seleccione Nuevo proyecto en la página Inicio).

En el cuadro de diálogo Nuevo proyecto, seleccione Web en el panel izquierdo y ASP.NET Web Application (.NET Framework) en el panel central. Asigne el nombre BookService al proyecto y haga clic en Aceptar.

Screenshot of the New Project dialog with the Web option in the left pane and A S P dot Net Web Application in the middle pane highlighted.

En el cuadro de diálogo Nuevo proyecto de ASP.NET, seleccione la plantilla API web.

Screenshot of the New A S P dot Net Project dialog showing the Web API template highlighted in blue.

Seleccione Aceptar para crear el proyecto.

Configurar Azure (opcional)

Después de crear el proyecto, puede optar por implementar en Azure App Service Web Apps en cualquier momento.

  1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Publicar.

  2. En la ventana que aparece, seleccione Iniciar. Se abre el cuadro de diálogo Elegir un destino de publicación.

    Screenshot of the Pick a publish target dialog with the App Service option in the left pane and the Create New option in the middle pane selected.

  3. Seleccione Crear perfil. Aparecerá el cuadro de diálogo Crear servicio de aplicaciones.

    Screenshot of the Create App Service dialog with values entered into the app name, subscription, resource group, hosting plan, and insights fields.

    Acepte los valores predeterminados o escriba valores diferentes para el nombre de la aplicación, el grupo de recursos, el plan de hospedaje, la suscripción de Azure y la región geográfica.

  4. Seleccione Crear una base de datos SQL. Aparece el cuadro de diálogo Configurar SQL Server.

    Screenshot of the Configure S Q L Server dialog with values entered into the server name, location, admin name, and admin password fields.

    Acepte los valores predeterminados o escriba valores diferentes. Escriba un Nombre de usuario de administrador y Contraseña de administrador para la nueva base de datos. Seleccione Aceptar cuando termine. Vuelve a aparecer la página Crear App Service.

  5. Seleccione Crear para crear el perfil. Aparece un mensaje en la esquina inferior derecha que indica que la implementación está en curso. Después de un breve tiempo, vuelve a aparecer la ventana Publicar.

    Screenshot of the Publish window showing the newly-created profile, profile details, and management options.

    El perfil que creó para implementar la aplicación ya está disponible.

Siguiente