3.1 KiB
title | author | description | ms.author | ms.custom | ms.date | uid |
---|---|---|---|---|---|---|
Get started with ASP.NET Core | rick-anderson | A quick tutorial that creates and runs a simple Hello World app using ASP.NET Core. | riande | mvc | 05/31/2018 | getting-started |
Tutorial: Get started with ASP.NET Core
This tutorial shows how to use the .NET Core command-line interface to create an ASP.NET Core web app. You'll learn how to:
[!div class="checklist"]
- Create a web app project.
- Enable local HTTPS.
- Run the app.
- Edit a Razor page.
At the end, you'll have a working web app running on your local machine.
Prerequisites
Create a web app project
-
Open a command shell, and enter the following command:
dotnet new webapp -o aspnetcoreapp
Enable local HTTPS
- Trust the HTTPS development certificate:
Windows
dotnet dev-certs https --trust
The preceding command displays the following dialog:
Select Yes if you agree to trust the development certificate.
macOS
dotnet dev-certs https --trust
The preceding command displays the following message:
Trusting the HTTPS development certificate was requested. If the certificate is not already trusted we will run the following command: 'sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain <<certificate>>'
.
*This command might prompt you for your password to install the certificate on the system keychain.
Password:*
Enter your password if you agree to trust the development certificate.
Linux
See the documentation for your Linux distribution on how to trust the HTTPS development certificate.
Run the app
-
Run the following commands:
cd aspnetcoreapp dotnet run
-
Browse to https://localhost:5001. Click Accept to accept the privacy and cookie policy. This app doesn't keep personal information.
Edit a Razor page
-
Open Pages/About.cshtml and modify the page with the following highlighted markup:
-
Browse to https://localhost:5001/About and verify the changes are displayed.
Next steps
In this tutorial, you learned how to:
[!div class="checklist"]
- Create a web app project.
- Enable local HTTPS.
- Run the project.
- Make a change.
To learn more about ASP.NET Core, see the introduction:
[!div class="nextstepaction"] xref:index
[!NOTE] We’re testing the usability of a proposed new structure for the ASP.NET Core table of contents. If you have a few minutes to try an exercise of finding 7 different topics in the current or proposed table of contents, please click here to participate in the study.