-->
By Rick Anderson
May 19, 2016 I am not a developer but rather a Windows Server engineer (among other things) trying to build a simple ASP.NET claims ware app (following a blog post I found), but after installed every thing in my LAB I am missing the Visual Studio templates I need. I am not a developer but rather a Windows Server engineer (among other things) trying to build a simple ASP.NET claims ware app (following a blog post I found), but after installed every thing in my LAB I am missing the Visual Studio templates I need. All the steps I a have taken are described in the above link.
This tutorial teaches ASP.NET Core MVC web development with controllers and views. If you're new to ASP.NET Core web development, consider the Razor Pages version of this tutorial, which provides an easier starting point.
This tutorial teaches the basics of building an ASP.NET Core MVC web app.
The app manages a database of movie titles. You learn how to:
- Create a web app.
- Add and scaffold a model.
- Work with a database.
- Add search and validation.
At the end, you have an app that can manage and display movie data.
View or download sample code (how to download).
Prerequisites
- Visual Studio 2019 with the ASP.NET and web development workload
The Visual Studio Code instructions use the .NET Core 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.
Create a web app
From the Visual Studio select Create a new project.
Select ASP.NET Core Web Application and then select Next.
Name the project MvcMovie and select Create. It's important to name the project MvcMovie so when you copy code, the namespace will match.
Select Web Application(Model-View-Controller), and then select Create.
Visual Studio used the default template for the MVC project you just created. You have a working app right now by entering a project name and selecting a few options. This is a basic starter project.
The tutorial assumes familarity with VS Code. See Getting started with VS Code and Visual Studio Code help for more information.
Open the integrated terminal.
Change directories (
cd
) to a folder which will contain the project.Run the following command:
A dialog box appears with Required assets to build and debug are missing from 'MvcMovie'. Add them? Select Yes
dotnet new mvc -o MvcMovie
: creates a new ASP.NET Core MVC project in the MvcMovie folder.code -r MvcMovie
: Loads the MvcMovie.csproj project file in Visual Studio Code.
Select File > New Solution.
Select .NET Core > App > Web Application (Model-View-Controller) > Next.
In the Configure your new ASP.NET Core Web API dialog, set the Target Framework of .NET Core 3.0.
- Name the project MvcMovie, and then select Create.
Run the app
Select Ctrl-F5 to run the app in non-debug mode.
Visual Studio displays the following dialog:
Select Yes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
Select Yes if you agree to trust the development certificate.
See Trust the ASP.NET Core HTTPS development certificate for more information.
Visual Studio starts IIS Express and runs the app. Notice that the address bar shows
localhost:port#
and not something likeexample.com
. That's becauselocalhost
is the standard hostname for your local computer. When Visual Studio creates a web project, a random port is used for the web server.Launching the app with Ctrl+F5 (non-debug mode) allows you to make code changes, save the file, refresh the browser, and see the code changes. Many developers prefer to use non-debug mode to quickly launch the app and view changes.
You can launch the app in debug or non-debug mode from the Debug menu item:
You can debug the app by selecting the IIS Express button
The following image shows the app:
Press Ctrl+F5 to run without the debugger.
Trust the HTTPS development certificate by running the following command:
The preceding command doesn't work on Linux. See your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog:
Select Yes if you agree to trust the development certificate.
See Trust the ASP.NET Core HTTPS development certificate for more information.
Visual Studio Code starts Kestrel, launches a browser, and navigates to https://localhost:5001
. The address bar shows localhost:port:5001
and not something like example.com
. That's because localhost
is the standard hostname for local computer. Localhost only serves web requests from the local computer.
Launching the app with Ctrl+F5 (non-debug mode) allows you to make code changes, save the file, refresh the browser, and see the code changes. Many developers prefer to use non-debug mode to refresh the page and view changes.
Select Run > Start Without Debugging to launch the app. Visual Studio for Mac starts Kestrel server, launches a browser, and navigates to http://localhost:port
, where port is a randomly chosen port number.
Trust the HTTPS development certificate by running the following command:
The preceding command displays the following output:
Enter the admin username and password if prompted. The certificate will now be installed and trusted.
See Trust the ASP.NET Core HTTPS development certificate for more information.
The address bar shows
localhost:port#
and not something likeexample.com
. That's becauselocalhost
is the standard hostname for your local computer. 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 the Run menu.
The following image shows the app:
Visual Studio help
Visual Studio Code help
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 the Razor Pages version of this tutorial, which provides an easier starting point.
This tutorial teaches the basics of building an ASP.NET Core MVC web app.
The app manages a database of movie titles. You learn how to:
- Create a web app.
- Add and scaffold a model.
- Work with a database.
- Add search and validation.
At the end, you have an app that can manage and display movie data.
View or download sample code (how to download).
Prerequisites
- Visual Studio 2019 with the ASP.NET and web development workload
Warning
If you use Visual Studio 2017, see dotnet/sdk issue #3124 for information about .NET Core SDK versions that don't work with Visual Studio.
The Visual Studio Code instructions use the .NET Core 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.
Create a web app
From the Visual Studio select Create a new project.
Selecct ASP.NET Core Web Application and then select Next.
Name the project MvcMovie and select Create. It's important to name the project MvcMovie so when you copy code, the namespace will match.
Select Web Application(Model-View-Controller), and then select Create.
Visual Studio used the default template for the MVC project you just created. You have a working app right now by entering a project name and selecting a few options. This is a basic starter project, and it's a good place to start.
The tutorial assumes familarity with VS Code. See Getting started with VS Code and Visual Studio Code help for more information.
Open the integrated terminal.
Change directories (
cd
) to a folder which will contain the project.Run the following command:
A dialog box appears with Required assets to build and debug are missing from 'MvcMovie'. Add them? Select Yes
dotnet new mvc -o MvcMovie
: creates a new ASP.NET Core MVC project in the MvcMovie folder.code -r MvcMovie
: Loads the MvcMovie.csproj project file in Visual Studio Code.
Select File > New Solution.
Select .NET Core > App > Web Application (Model-View-Controller) > Next.
In the Configure your new ASP.NET Core Web API dialog, accept the default Target Framework of .NET Core 2.2.
Name the project MvcMovie, and then select Create.
Run the app
Select Ctrl-F5 to run the app in non-debug mode.
Visual Studio displays the following dialog:
Visual Studio Templates Download
Select Yes if you trust the IIS Express SSL certificate.
The following dialog is displayed:
Select Yes if you agree to trust the development certificate.
See Trust the ASP.NET Core HTTPS development certificate for more information.
Visual Studio starts IIS Express and runs the app. Notice that the address bar shows
localhost:port#
and not something likeexample.com
. That's becauselocalhost
is the standard hostname for your local computer. When Visual Studio creates a web project, a random port is used for the web server.Launching the app with Ctrl+F5 (non-debug mode) allows you to make code changes, save the file, refresh the browser, and see the code changes. Many developers prefer to use non-debug mode to quickly launch the app and view changes.
You can launch the app in debug or non-debug mode from the Debug menu item:
You can debug the app by selecting the IIS Express button
Select Accept to consent to tracking. This app doesn't track personal information. The template generated code includes assets to help meet General Data Protection Regulation (GDPR).
The following image shows the app after accepting tracking:
Visual Studio Html5 Project Template
Press Ctrl+F5 to run without the debugger.
Trust the HTTPS development certificate by running the following command:
The preceding command doesn't work on Linux. See your Linux distribution's documentation for trusting a certificate.
The preceding command displays the following dialog:
Select Yes if you agree to trust the development certificate.
See Trust the ASP.NET Core HTTPS development certificate for more information.
Visual Studio Code starts Kestrel, launches a browser, and navigates to https://localhost:5001
. The address bar shows localhost:port:5001
and not something like example.com
. That's because localhost
is the standard hostname for local computer. Localhost only serves web requests from the local computer.
Launching the app with Ctrl+F5 (non-debug mode) allows you to make code changes, save the file, refresh the browser, and see the code changes. Many developers prefer to use non-debug mode to refresh the page and view changes.
Select Accept to consent to tracking. This app doesn't track personal information. The template generated code includes assets to help meet General Data Protection Regulation (GDPR).
The following image shows the app after accepting tracking:
Select Run > Start Without Debugging to launch the app. Visual Studio for Mac starts Kestrel server, launches a browser, and navigates to http://localhost:port
, where port is a randomly chosen port number.
Trust the HTTPS development certificate by running the following command:
The preceding command displays the following output:
Enter the admin username and password if prompted. The certificate will now be installed and trusted.
See Trust the ASP.NET Core HTTPS development certificate for more information.
The address bar shows
localhost:port#
and not something likeexample.com
. That's becauselocalhost
is the standard hostname for your local computer. 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 the Run menu.
Select Accept to consent to tracking. This app doesn't track personal information. The template generated code includes assets to help meet General Data Protection Regulation (GDPR).
The following image shows the app after accepting tracking:
Visual Studio help
Visual Studio Code help
Visual Studio for Mac help
In the next part of this tutorial, you learn about MVC and start writing some code.