Get started with ASP.NET Core MVC

[!INCLUDE]

:::moniker range=">= aspnetcore-10.0"

This is the first tutorial of a series that teaches ASP.NET Core MVC web development with controllers and views.

At the end of the series, you'll have an app that manages, validates, and displays movie data. You learn how to:

[!div class="checklist"]

Create a web app.

Add and scaffold a model.

Work with a database.

Add search and validation.

View or download sample code (how to download).

Prerequisites

Visual Studio

[!INCLUDE]

Visual Studio Code

[!INCLUDE]

Create a web app

Visual Studio

Start Visual Studio and select Create a new project.
In the Create a new project dialog, select ASP.NET Core Web App (Model-View-Controller) > Next.
In the Configure your new project dialog:
- Enter MvcMovie for Project name. It's important to name the project MvcMovie. Capitalization needs to match each namespace when code is copied.
- The Location for the project can be set to anywhere.
Select Next.
In the Additional information dialog:
- Select .NET 10.0 (Standard Term Support).
- Verify that Do not use top-level statements is unchecked.
Select Create.

:::image type="content" source="~/tutorials/first-mvc-app/start-mvc/media/net10-additional-info.png" alt-text="Additional info dialog.":::

For more information, including alternative approaches to create the project, see Create a new project in Visual Studio.

Visual Studio uses the default project template for the created MVC project. The created project:

Is a working app.
Is a basic starter project.

Visual Studio Code

The tutorial assumes familiarity with VS Code. For more information, see Getting started with VS Code and Visual Studio Code help.

Select New Terminal from the Terminal menu to open the integrated terminal.
Change to the directory (cd) that will contain the project. The project can be located anywhere.
Run the following commands:
dotnetcli
```
dotnet new mvc -o MvcMovie
code -r MvcMovie
```
The dotnet new command creates a new ASP.NET Core MVC project in the MvcMovie folder.

The code command opens the MvcMovie project folder in the current instance of Visual Studio Code.

[!INCLUDE]

Run the app

Visual Studio

Press <kbd>Ctrl</kbd>+<kbd>F5</kbd> to run the app without the debugger.

[!INCLUDE]

Visual Studio runs the app and opens the default browser.

The address bar shows localhost:<port#> and not something like example.com. The standard hostname for your local computer is localhost. When Visual Studio creates a web project, a random port is used for the web server.

Launching the app without debugging by pressing <kbd>Ctrl</kbd>+<kbd>F5</kbd> allows you to:

Make code changes.
Save the file.
Quickly refresh the browser and see the code changes.

You can launch the app in debug or non-debug mode from the Debug menu:

:::image type="content" source="~/tutorials/first-mvc-app/start-mvc/media/debug-menu.png" alt-text="Start Debug and Start Without Debugging menus.":::

You can debug the app by selecting the https button in the toolbar:

:::image type="content" source="~/tutorials/first-mvc-app/start-mvc/media/debug-button.png" alt-text="MvcMovie debug button.":::

The following image shows the app:

:::image type="content" source="~/tutorials/first-mvc-app/start-mvc/media/mvc-movie-home-page.png" alt-text="Home or Index page.":::

Close the browser window. Visual Studio will stop the application.

Visual Studio Code

[!INCLUDE]

In Visual Studio Code, press <kbd>Ctrl</kbd>+<kbd>F5</kbd> (Windows)/<kbd>^</kbd>+<kbd>F5</kbd> (macOS) to run the app without debugging.

Visual Studio Code:
- Starts Kestrel
- Launches a browser.
- Navigates to https://localhost:<port#>.
The address bar shows localhost:<port#> and not something like example.com. The standard hostname for your local computer is localhost. Localhost only serves web requests from the local computer.

Launching the app without debugging by selecting Ctrl+F5 allows you to:

Make code changes.
Save the file.
Quickly refresh the browser and see the code changes.

:::image type="content" source="~/tutorials/first-mvc-app/start-mvc//media/mvc-movie-home-page.png" alt-text="Home or Index page.":::
Close the browser window.
In Visual Studio Code, from the Run menu, select Stop Debugging or press <kbd>Shift</kbd>+<kbd>F5</kbd> to stop the app.

[!INCLUDE]

In the next tutorial in this series, you learn about MVC and start writing some code.

[!div class="step-by-step"] Next: Add a controller

:::moniker-end

[!INCLUDE]