3.1 KiB
| title | author | description | ms.author | ms.custom | ms.date | uid |
|---|---|---|---|---|---|---|
| Get started with ASP.NET Core | rick-anderson | A short tutorial that creates and runs a basic Hello World app using ASP.NET Core. | riande | mvc | 05/15/2019 | getting-started |
Tutorial: Get started with ASP.NET Core
This tutorial shows how to use the .NET Core command-line interface to create and run an ASP.NET Core web app.
You'll learn how to:
[!div class="checklist"]
- Create a web app project.
- Trust the development certificate.
- 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
Trust the development certificate
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. Enter your password if you agree to trust the development certificate.
Linux
For Windows Subsystem for Linux, see Trust HTTPS certificate from Windows Subsystem for Linux.
See the documentation for your Linux distribution on how to trust the HTTPS development certificate.
For more information, see Trust the ASP.NET Core HTTPS development certificate
Run the app
Run the following commands:
cd aspnetcoreapp
dotnet run
After the command shell indicates that the app has started, 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/Index.cshtml and modify the page with the following highlighted markup:
Browse to https://localhost:5001, and verify the changes are displayed.
Next steps
In this tutorial, you learned how to:
[!div class="checklist"]
- Create a web app project.
- Trust the development certificate.
- Run the project.
- Make a change.
To learn more about ASP.NET Core, see the recommended learning path in the introduction:
[!div class="nextstepaction"] xref:index#recommended-learning-path