ByRick Anderson
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider theRazor Pages version of this tutorial, which provides an easier starting point. SeeChoose an ASP.NET Core UI, which compares Razor Pages, MVC, and Blazor for UI development.
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:
- 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
You can follow the Visual Studio Code instructions on macOS, Linux, or Windows. Changes may be required if you use an integrated development environment (IDE) other than Visual Studio Code.
Create a web app
- Start Visual Studio and selectCreate a new project.
- In theCreate a new project dialog, selectASP.NET Core Web App (Model-View-Controller) >Next.
- In theConfigure your new project dialog:
- Enter
MvcMovie forProject name. It's important to name the projectMvcMovie. Capitalization needs to match eachnamespace when code is copied. - TheLocation for the project can be set to anywhere.
- SelectNext.
- In theAdditional information dialog:
- Select.NET 9.0 (Standard Term Support).
- Verify thatDo not use top-level statements is unchecked.
- SelectCreate.
For more information, including alternative approaches to create the project, seeCreate 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.
The tutorial assumes familiarity with VS Code. For more information, seeGetting started with VS Code andVisual Studio Code help.
SelectNew Terminal from theTerminal menu to open theintegrated terminal.
Change to the directory (cd) that will contain the project. The project can be located anywhere.
Run the following commands:
dotnet new mvc -o MvcMoviecode -r MvcMovie
Thedotnet new command creates a new ASP.NET Core MVC project in theMvcMovie folder.
Thecode command opens theMvcMovie project folder in the current instance of Visual Studio Code.
Visual Studio Code might display a dialog box that asks:Do you trust the authors of the files in this folder?
- If you trust all files in the parent folder, selectTrust the authors of all files in the parent folder.
- SelectYes, I trust the authors since the project folder has files generated by .NET.
- When Visual Studio Code requests that you add assets to build and debug the project, selectYes. If Visual Studio Code doesn't offer to add build and debug assets, selectView >Command Palette and type "
.NET" into the search box. From the list of commands, select the.NET: Generate Assets for Build and Debug command.
Visual Studio Code adds a.vscode folder with generatedlaunch.json andtasks.json files.
Run the app
PressCtrl+F5 to run the app without the debugger.
Visual Studio displays the following dialog when a project is not yet configured to use SSL:
SelectYes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
SelectYes if you agree to trust the development certificate.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio runs the app and opens the default browser.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
Launching the app without debugging by pressingCtrl+F5 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 theDebug menu:
You can debug the app by selecting thehttps button in the toolbar:
The following image shows the app:
- Close the browser window. Visual Studio will stop the application.
Trust the HTTPS development certificate by running the following command:
dotnet dev-certs https --trust
The preceding command requires .NET 9 or later SDK on Linux. For Linux on .NET 8.0.401 or earlier SDK, see your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog, provided the certificate was not previously trusted:
SelectYes if you agree to trust the development certificate.
For more information, see theTrust the ASP.NET Core HTTPS development certificate section of theEnforcing SSL article.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
In Visual Studio Code, pressCtrl+F5 (Windows)/^+F5 (macOS) to run the app without debugging.
Visual Studio Code:
- StartsKestrel
- Launches a browser.
- Navigates to
https://localhost:<port#>.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. 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.
Close the browser window.
In Visual Studio Code, from theRun menu, selectStop Debugging or pressShift+F5 to stop the app.
In the next tutorial in this series, you learn about MVC and start writing some code.
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider theRazor Pages version of this tutorial, which provides an easier starting point. SeeChoose an ASP.NET Core UI, which compares Razor Pages, MVC, and Blazor for UI development.
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 and displays movie data. You learn how to:
- 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
The Visual Studio Code instructions use the .NET CLI for ASP.NET Core development functions such as project creation. You can follow these instructions on macOS, Linux, or Windows and with any code editor. Minor changes may be required if you use something other than Visual Studio Code.
Create a web app
- Start Visual Studio and selectCreate a new project.
- In theCreate a new project dialog, selectASP.NET Core Web App (Model-View-Controller) >Next.
- In theConfigure your new project dialog:
- Enter
MvcMovie forProject name. It's important to name the projectMvcMovie. Capitalization needs to match eachnamespace when code is copied. - TheLocation for the project can be set to anywhere.
- SelectNext.
- In theAdditional information dialog:
- Select.NET 8.0 (Long Term Support).
- Verify thatDo not use top-level statements is unchecked.
- SelectCreate.
For more information, including alternative approaches to create the project, seeCreate 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.
The tutorial assumes familiarity with VS Code. For more information, seeGetting started with VS Code andVisual Studio Code help.
SelectNew Terminal from theTerminal menu to open theintegrated terminal.
Change to the directory (cd) that will contain the project. The project can be located anywhere.
Run the following commands:
dotnet new mvc -o MvcMoviecode -r MvcMovie
Thedotnet new command creates a new ASP.NET Core MVC project in theMvcMovie folder.
Thecode command opens theMvcMovie project folder in the current instance of Visual Studio Code.
Visual Studio Code might display a dialog box that asks:Do you trust the authors of the files in this folder?
- If you trust all files in the parent folder, selectTrust the authors of all files in the parent folder.
- SelectYes, I trust the authors since the project folder has files generated by .NET.
- When Visual Studio Code requests that you add assets to build and debug the project, selectYes. If Visual Studio Code doesn't offer to add build and debug assets, selectView >Command Palette and type "
.NET" into the search box. From the list of commands, select the.NET: Generate Assets for Build and Debug command.
Visual Studio Code adds a.vscode folder with generatedlaunch.json andtasks.json files.
Run the app
PressCtrl+F5 to run the app without the debugger.
Visual Studio displays the following dialog when a project is not yet configured to use SSL:
SelectYes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
SelectYes if you agree to trust the development certificate.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio runs the app and opens the default browser.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
Launching the app without debugging by pressingCtrl+F5 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 theDebug menu:
You can debug the app by selecting thehttps button in the toolbar:
The following image shows the app:
- Close the browser window. Visual Studio will stop the application.
Trust the HTTPS development certificate by running the following command:
dotnet dev-certs https --trust
The preceding command requires .NET 9 or later SDK on Linux. For Linux on .NET 8.0.401 or earlier SDK, see your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog, provided the certificate was not previously trusted:
SelectYes if you agree to trust the development certificate.
For more information, see theTrust the ASP.NET Core HTTPS development certificate section of theEnforcing SSL article.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
In Visual Studio Code, pressCtrl+F5 (Windows)/^+F5 (macOS) to run the app without debugging.
Visual Studio Code:
- StartsKestrel
- Launches a browser.
- Navigates to
https://localhost:<port#>.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. 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.
Close the browser window.
In Visual Studio Code, from theRun menu, selectStop Debugging or pressShift+F5 to stop the app.
Visual Studio for Mac help
In the next tutorial in this series, you learn about MVC and start writing some code.
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider theRazor Pages version of this tutorial, which provides an easier starting point. SeeChoose an ASP.NET Core UI, which compares Razor Pages, MVC, and Blazor for UI development.
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 and displays movie data. You learn how to:
- 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
The Visual Studio Code instructions use the .NET CLI for ASP.NET Core development functions such as project creation. You can follow these instructions on macOS, Linux, or Windows and with any code editor. Minor changes may be required if you use something other than Visual Studio Code.
Create a web app
- Start Visual Studio and selectCreate a new project.
- In theCreate a new project dialog, selectASP.NET Core Web App (Model-View-Controller) >Next.
- In theConfigure your new project dialog:
- Enter
MvcMovie forProject name. It's important to name the projectMvcMovie. Capitalization needs to match eachnamespace when code is copied. - TheLocation for the project can be set to anywhere.
- SelectNext.
- In theAdditional information dialog:
- Select.NET 7.0.
- Verify thatDo not use top-level statements is unchecked.
- SelectCreate.
For more information, including alternative approaches to create the project, seeCreate 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.
The tutorial assumes familiarity with VS Code. For more information, seeGetting started with VS Code.
SelectNew Terminal from theTerminal menu to open theintegrated terminal.
Change to the directory (cd) that will contain the project. The project can be located anywhere.
Run the following commands:
dotnet new mvc -o MvcMoviecode -r MvcMovie
Thedotnet new command creates a new ASP.NET Core MVC project in theMvcMovie folder.
Thecode command opens theMvcMovie project folder in the current instance of Visual Studio Code.
Visual Studio Code might display a dialog box that asks:Do you trust the authors of the files in this folder?
- If you trust all files in the parent folder, selectTrust the authors of all files in the parent folder.
- SelectYes, I trust the authors since the project folder has files generated by .NET.
- When Visual Studio Code requests that you add assets to build and debug the project, selectYes. If Visual Studio Code doesn't offer to add build and debug assets, selectView >Command Palette and type "
.NET" into the search box. From the list of commands, select the.NET: Generate Assets for Build and Debug command.
Visual Studio Code adds a.vscode folder with generatedlaunch.json andtasks.json files.
- Start Visual Studio for Mac and selectFile >New Project....
- In Visual Studio for Mac selectWeb and Console >App >Web Application (Model-View-Controller) >Continue.
- In theConfigure your new Web Application (Model-View-Controller) dialog:
- Select.NET 7.0 for theTarget Framework.
- Verify thatDo not use top-level statements is unchecked.
- SelectContinue.
- Enter
MvcMovie forProject name. It's important to name the projectMvcMovie. Capitalization needs to match eachnamespace when code is copied. - TheLocation for the project can be set to anywhere.
- SelectCreate.
Run the app
- PressCtrl+F5 to run the app without the debugger.Visual Studio displays the following dialog when a project is not yet configured to use SSL:SelectYes if you trust the IIS Express SSL certificate.The following dialog is displayed:SelectYes if you agree to trust the development certificate.For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio runs the app and opens the default browser.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
Launching the app without debugging by pressingCtrl+F5 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 theDebug menu:
You can debug the app by selecting thehttps button in the toolbar:
The following image shows the app:
- Close the browser window. Visual Studio will stop the application.
Trust the HTTPS development certificate by running the following command:
dotnet dev-certs https --trust
The preceding command requires .NET 9 or later SDK on Linux. For Linux on .NET 8.0.401 or earlier SDK, see your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog, provided the certificate was not previously trusted:
SelectYes if you agree to trust the development certificate.
For more information, see theTrust the ASP.NET Core HTTPS development certificate section of theEnforcing SSL article.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
In Visual Studio Code, pressCtrl+F5 (Windows)/^+F5 (macOS) to run the app without debugging.
Visual Studio Code:
- StartsKestrel
- Launches a browser.
- Navigates to
https://localhost:<port#>.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. 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.
Close the browser window.
In Visual Studio Code, from theRun menu, selectStop Debugging or pressShift+F5 to stop the app.
Select Option+Command+Return to run the app without the debugger.
Visual Studio for Mac:
- StartsKestrel server.
- Launches a browser.
- Navigates to
http://localhost:port, whereport is a randomly chosen port number, set when Visual Studio creates a web project.
Visual Studio for Mac displays the following popup:
- SelectInstall and Trust if you trust the development certificate.
The following dialog is displayed:
- Enter your password and selectUpdate Settings.
SeeTrust the ASP.NET Core HTTPS development certificate for more information.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. Localhost only serves web requests from the local computer.
You can launch the app in debug or non-debug mode from theDebug menu.
The following image shows the app:
- Close the browser window. Visual Studio for Mac will stop the application.
Visual Studio for Mac help
In the next tutorial in this series, you learn about MVC and start writing some code.
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider theRazor Pages version of this tutorial, which provides an easier starting point. SeeChoose an ASP.NET Core UI, which compares Razor Pages, MVC, and Blazor for UI development.
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 and displays movie data. You learn how to:
- 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
The Visual Studio Code instructions use the .NET CLI for ASP.NET Core development functions such as project creation. You can follow these instructions on macOS, Linux, or Windows and with any code editor. Minor changes may be required if you use something other than Visual Studio Code.
For Visual Studio for Mac, see the .NET 7 version of this tutorial.
Create a web app
- Start Visual Studio and selectCreate a new project.
- In theCreate a new project dialog, selectASP.NET Core Web App (Model-View-Controller) >Next.
- In theConfigure your new project dialog, enter
MvcMovie forProject name. It's important to name the projectMvcMovie. Capitalization needs to match eachnamespace when code is copied. - SelectNext.
- In theAdditional information dialog, select.NET 6.0 (Long-term support).
- SelectCreate.
For alternative approaches to create the project, seeCreate 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.
The tutorial assumes familiarity with VS Code. For more information, seeGetting started with VS Code andVisual Studio Code help.
SelectNew Terminal from theTerminal menu to open theintegrated terminal.
Change to the directory (cd) that will contain the project.
Run the following commands:
dotnet new mvc -o MvcMoviecode -r MvcMovie
Thedotnet new command creates a new ASP.NET Core MVC project in theMvcMovie folder.
Thecode command opens theMvcMovie project folder in the current instance of Visual Studio Code.
Visual Studio Code might display a dialog box that asks:Do you trust the authors of the files in this folder?
- If you trust all files in the parent folder, selectTrust the authors of all files in the parent folder.
- SelectYes, I trust the authors since the project folder has files generated by .NET.
- When Visual Studio Code requests that you add assets to build and debug the project, selectYes. If Visual Studio Code doesn't offer to add build and debug assets, selectView >Command Palette and type "
.NET" into the search box. From the list of commands, select the.NET: Generate Assets for Build and Debug command.
Visual Studio Code adds a.vscode folder with generatedlaunch.json andtasks.json files.
For Visual Studio for Mac, see the .NET 7 version of this tutorial.
Run the app
Select Ctrl+F5 to run the app without the debugger.
Visual Studio displays the following dialog when a project is not yet configured to use SSL:
SelectYes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
SelectYes if you agree to trust the development certificate.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio runs the app and opens the default browser.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
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.
You can launch the app in debug or non-debug mode from theDebug menu:
You can debug the app by selecting theMvcMovie button in the toolbar:
The following image shows the app:
Select Ctrl+F5 to run without the debugger.
Trust the HTTPS development certificate by running the following command:
dotnet dev-certs https --trust
The preceding command requires .NET 9 or later SDK on Linux. For Linux on .NET 8.0.401 or earlier SDK, see your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog, provided the certificate was not previously trusted:
SelectYes if you agree to trust the development certificate.
For more information, see theTrust the ASP.NET Core HTTPS development certificate section of theEnforcing SSL article.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio Code:
- StartsKestrel
- Launches a browser.
- Navigates to
https://localhost:<port#>.
The address bar showslocalhost:<port#> and not something likeexample.com. The standard hostname for your local computer islocalhost. Localhost only serves web requests from the local computer.
Launching the app without debugging by selecting Ctrl+F5 allows you to:
For Visual Studio for Mac, see the .NET 7 version of this tutorial.
Visual Studio for Mac help
In the next tutorial in this series, you learn about MVC and start writing some code.
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider theRazor Pages version of this tutorial, which provides an easier starting point. SeeChoose an ASP.NET Core UI, which compares Razor Pages, MVC, and Blazor for UI development.
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 and displays movie data. You learn how to:
- 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
The Visual Studio Code instructions use the .NET CLI for ASP.NET Core development functions such as project creation. You can follow these instructions on macOS, Linux, or Windows and with any code editor. Minor changes may be required if you use something other than Visual Studio Code.
Create a web app
- Start Visual Studio and selectCreate a new project.
- In theCreate a new project dialog, selectASP.NET Core Web Application >Next.
- In theConfigure your new project dialog, enter
MvcMovie forProject name. It's important to name the projectMvcMovie. Capitalization needs to match eachnamespace matches when code is copied. - SelectCreate.
- In theCreate a new ASP.NET Core web application dialog, select:
- .NET Core andASP.NET Core 5.0 in the dropdowns.
- ASP.NET Core Web App (Model-View-Controller).
- Create.
For alternative approaches to create the project, seeCreate a new project in Visual Studio.
Visual Studio used the default project template for the created MVC project. The created project:
- Is a working app.
- Is a basic starter project.
The tutorial assumes familiarity with VS Code. For more information, seeGetting started with VS Code.
SelectNew Terminal from theTerminal menu to open theintegrated terminal.
Change to the directory (cd) that will contain the project.
Run the following commands:
dotnet new mvc -o MvcMoviecode -r MvcMovie
Thedotnet new command creates a new ASP.NET Core MVC project in theMvcMovie folder.
Thecode command opens theMvcMovie project folder in the current instance of Visual Studio Code.
Visual Studio Code might display a dialog box that asks:Do you trust the authors of the files in this folder?
- If you trust all files in the parent folder, selectTrust the authors of all files in the parent folder.
- SelectYes, I trust the authors since the project folder has files generated by .NET.
- When Visual Studio Code requests that you add assets to build and debug the project, selectYes. If Visual Studio Code doesn't offer to add build and debug assets, selectView >Command Palette and type "
.NET" into the search box. From the list of commands, select the.NET: Generate Assets for Build and Debug command.
Visual Studio Code adds a.vscode folder with generatedlaunch.json andtasks.json files.
SelectFile >New Solution.
In Visual Studio for Mac earlier than version 8.6, select.NET Core >App >Web Application (Model-View-Controller) >Next. In version 8.6 or later, selectWeb and Console >App >Web Application (Model-View-Controller) >Next.
In theConfigure your new Web Application dialog:
- Confirm thatAuthentication is set toNo Authentication.
- If an option to select aTarget Framework is presented, select the latest 5.x version.
- SelectNext.
Name the projectMvcMovie, and then selectCreate.
Run the app
Select Ctrl+F5 to run the app without the debugger.
Visual Studio displays the following dialog when a project is not yet configured to use SSL:
SelectYes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
SelectYes if you agree to trust the development certificate.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio:
The address bar showslocalhost:port# and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
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.
You can launch the app in debug or non-debug mode from theDebug menu item:
You can debug the app by selecting theIIS Express button
The following image shows the app:
Select Ctrl+F5 to run without the debugger.
Trust the HTTPS development certificate by running the following command:
dotnet dev-certs https --trust
The preceding command requires .NET 9 or later SDK on Linux. For Linux on .NET 8.0.401 or earlier SDK, see your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog, provided the certificate was not previously trusted:
SelectYes if you agree to trust the development certificate.
For more information, see theTrust the ASP.NET Core HTTPS development certificate section of theEnforcing SSL article.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio Code:
- StartsKestrel
- Launches a browser.
- Navigates to
https://localhost:5001.
The address bar showslocalhost:port:5001 and not something likeexample.com. The standard hostname for your local computer islocalhost. Localhost only serves web requests from the local computer.
Launching the app without debugging by selecting Ctrl+F5 allows you to:
SelectRun >Start Without Debugging to launch the app.
Visual Studio for Mac:
- StartsKestrel server.
- Launches a browser.
- Navigates to
http://localhost:port, whereport is a randomly chosen port number.
Visual Studio for Mac displays the following popup:
SelectYes if you trust the development certificate.
The following dialog is displayed:
Enter your password and selectOK
SelectYes if you agree to trust the development certificate.
SeeTrust the ASP.NET Core HTTPS development certificate for more information.
The address bar showslocalhost:port# and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
You can launch the app in debug or non-debug mode from theRun menu.
The following image shows the app:
Visual Studio for Mac help
In the next part of this tutorial, you learn about MVC and start writing some code.
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider theRazor Pages version of this tutorial, which provides an easier starting point. SeeChoose an ASP.NET Core UI, which compares Razor Pages, MVC, and Blazor for UI development.
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 and displays movie data. You learn how to:
- 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
The Visual Studio Code instructions use the .NET CLI for ASP.NET Core development functions such as project creation. You can follow these instructions on any platform (macOS, Linux, or Windows) and with any code editor. Minor changes may be required if you use something other than Visual Studio Code. For more information on installing Visual Studio Code on macOS, seeVisual Studio Code on macOS.
Create a web app
From the Visual Studio, selectCreate a new project.
SelectASP.NET Core Web Application >Next.
Name the projectMvcMovie and selectCreate. It's important to name the projectMvcMovie so when you copy code, the namespace will match.
SelectWeb Application(Model-View-Controller). From the dropdown boxes, select.NET Core andASP.NET Core 3.1, then selectCreate.
Visual Studio used the default project template for the created MVC project. The created project:
- Is a working app.
- Is a basic starter project.
The tutorial assumes familiarity with VS Code. For more information, seeGetting started with VS Code andVisual Studio Code help.
Open theintegrated terminal.
Change directories (cd) to a folder that will contain the project.
Run the following command:
dotnet new mvc -o MvcMoviecode -r MvcMovie
A dialog box appears withRequired assets to build and debug are missing from 'MvcMovie'. Add them?, selectYes.
dotnet new mvc -o MvcMovie: Creates a new ASP.NET Core MVC project in theMvcMovie folder.
code -r MvcMovie: Loads theMvcMovie.csproj project file in Visual Studio Code.
SelectFile >New Solution.
In Visual Studio for Mac earlier than version 8.6, select.NET Core >App >Web Application (Model-View-Controller) >Next. In version 8.6 or later, selectWeb and Console >App >Web Application (Model-View-Controller) >Next.
In theConfigure your new Web Application dialog:
- Confirm thatAuthentication is set toNo Authentication.
- If an option to select aTarget Framework is presented, select the latest 3.x version.
- SelectNext.
Name the projectMvcMovie, and then selectCreate.
Run the app
Select Ctrl+F5 to run the app without debugging.
Visual Studio displays the following dialog when a project is not yet configured to use SSL:
SelectYes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
SelectYes if you agree to trust the development certificate.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio:
The address bar showslocalhost:port# and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server.
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.
You can launch the app in debug or non-debug mode from theDebug menu item:
You can debug the app by selecting theIIS Express button
The following image shows the app:
Select Ctrl+F5 to run the app without debugging.
Trust the HTTPS development certificate by running the following command:
dotnet dev-certs https --trust
The preceding command requires .NET 9 or later SDK on Linux. For Linux on .NET 8.0.401 or earlier SDK, see your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog, provided the certificate was not previously trusted:
SelectYes if you agree to trust the development certificate.
For more information, see theTrust the ASP.NET Core HTTPS development certificate section of theEnforcing SSL article.
For information on trusting the Firefox browser, seeFirefox SEC_ERROR_INADEQUATE_KEY_USAGE certificate error.
Visual Studio Code:
- StartsKestrel
- Launches a browser.
- Navigates to
https://localhost:5001.
The address bar showslocalhost:port:5001 and not something likeexample.com. The standard hostname for your local computer islocalhost. Localhost only serves web requests from the local computer.
Launching the app without debugging by selecting Ctrl+F5 allows you to:
SelectRun >Start Without Debugging to launch the app.
Visual Studio for Mac: startsKestrel server, launches a browser, and navigates tohttp://localhost:port, whereport is a randomly chosen port number.
Visual Studio for Mac displays the following popup:
SelectYes if you trust the development certificate.
The following dialog is displayed:
Enter your password and selectOK
SelectYes if you agree to trust the development certificate.
SeeTrust the ASP.NET Core HTTPS development certificate for more information.
The address bar showslocalhost:port# and not something likeexample.com. The standard hostname for your local computer islocalhost. When Visual Studio creates a web project, a random port is used for the web server. When you run the app, you'll see a different port number.
You can launch the app in debug or non-debug mode from theRun menu.
The following image shows the app:
Visual Studio for Mac help
In the next part of this tutorial, you learn about MVC and start writing some code.
