AspNetCore.Docs/aspnetcore/toc.md

25 KiB

Introduction

What's new

What's new

What's new

Get started

Create a web app

Create a Web API

Tutorials

Create a Razor Pages web app

Get started with Razor Pages

Add a model

Scaffolded Razor Pages

SQL Server LocalDB

Update the pages

Add a new field

Add validation

Upload files

Create a real-time SignalR web app

Create an MVC web app

Get started

Add a controller

Add a view

Add a model

Work with SQL Server LocalDB

Controller methods and views

Add search

Add a new field

Add validation

Examine the Details and Delete methods

Build Web APIs

Create a Web API in Visual Studio Code

Create a Web API in Visual Studio for Mac

Create a Web API in Visual Studio for Windows

Create backend services for native mobile apps

Help pages using Swagger

Get started with NSwag

Get started with Swashbuckle

Data access - with EF Core

Data access - with Razor Pages and EF Core

Get started

Create, Read, Update, and Delete operations

Sort, filter, page, and group

Migrations

Create a complex data model

Handle concurrency conflicts

Data access - MVC with EF Core

Get started

Create, Read, Update, and Delete operations

Sort, filter, page, and group

Migrations

Create a complex data model

Handle concurrency conflicts

Inheritance

Advanced topics

Cross platform tutorials

Razor Pages web app on macOS

Get started with Razor Pages

Add a model

Scaffolded Razor Pages

Work with SQLite

Update the pages

Razor Pages web app with VS Code

Get started with Razor Pages

Add a model

Scaffolded Razor Pages

Work with SQLite

Update the pages

MVC web app with Visual Studio for Mac

Get started

Add a controller

Add a view

Add a model

Work with SQLite

Controller methods and views

Add a new field

Add validation

Examine the Details and Delete methods

MVC web app with Visual Studio Code on macOS or Linux

Get started

Add a controller

Add a view

Add a model

Work with SQLite

Controller methods and views

Add search

Add a new field

Add validation

Examine the Details and Delete methods

Web API with Visual Studio for Mac

Web API with Visual Studio Code

Develop apps using a file watcher

Create backend services for mobile apps

Fundamentals

Application startup

Dependency injection (services)

Middleware

Middleware

Factory-based middleware

Factory-based middleware with third-party container

Static files

Routing

URL rewriting middleware

Use multiple environments

Configuration and options

Configuration

Options

Enhance an app from an external assembly

Logging

Logging with LoggerMessage

Handle errors

File providers

Host

Web Host

Generic Host

Background tasks with hosted services

Session and app state

Servers

Kestrel

ASP.NET Core Module

HTTP.sys

Globalization and localization

Configure Portable Object localization with Orchard Core

Initiate HTTP requests

Request features

Primitives

Change tokens

Open Web Interface for .NET (OWIN)

WebSockets

Microsoft.AspNetCore.App metapackage

Microsoft.AspNetCore.All metapackage

Choose between .NET Core and .NET Framework

Choose between ASP.NET Core and ASP.NET

Razor Pages

Filter methods for Razor Pages

Create a Razor Class Library

Route and app conventions

Razor SDK

MVC

Model binding

Model validation

Views

Razor syntax

View compilation

Layout

Tag Helpers

Create Tag Helpers

Use Tag Helpers in forms

Built-in Tag Helpers

Anchor Tag Helper
Cache Tag Helper
Distributed Cache Tag Helper
Environment Tag Helper
Form Tag Helper
Image Tag Helper
Input Tag Helper
Label Tag Helper
Partial Tag Helper
Select Tag Helper
Textarea Tag Helper
Validation Message Tag Helper
Validation Summary Tag Helper

Partial views

Dependency injection into views

View components

Controllers

Route to controller actions

File uploads

Dependency injection into controllers

Test controllers

Advanced

Work with the app model

Filters

Areas

Application parts

Custom model binding

Web API

Controller action return types

Advanced

Custom formatters

Format response data

Test, debug, and troubleshoot

Unit testing

Integration tests

Razor Pages unit tests

Test controllers

Remote debugging

Snapshot debugging

Snapshot debugging in Visual Studio

Troubleshoot

Data access with EF Core and Azure

Get started with Razor Pages and EF Core using Visual Studio

Get started with ASP.NET Core and EF Core using Visual Studio

ASP.NET Core with EF Core - new database

ASP.NET Core with EF Core - existing database

Get started with ASP.NET Core and Entity Framework 6

Azure Storage

Add Azure Storage by using Visual Studio Connected Services

Get started with Blob storage and Visual Studio Connected Services

Get Started with Queue Storage and Visual Studio Connected Services

Get Started with Table Storage and Visual Studio Connected Services

Client-side development

Use Gulp

Use Grunt

Manage client-side packages with Bower

Build responsive sites with Bootstrap

Style apps with LESS, Sass, and Font Awesome

Bundle and minify

Use JavaScriptServices for SPAs

Use the SPA project templates

Angular project template

React project template

React with Redux project template

SignalR

Introduction

Hubs

JavaScript client

.NET client

HubContext

Users and Groups

MessagePack Hub Protocol

Publish to Azure

Streaming

Supported platforms

Mobile

Create backend services for native mobile apps

Host and deploy

Host on Azure App Service

Publish to Azure with Visual Studio

Publish to Azure with CLI tools

Continuous deployment to Azure with Visual Studio and Git

Continuous deployment to Azure with VSTS

Troubleshoot ASP.NET Core on Azure App Service

Host on Windows with IIS

Troubleshoot ASP.NET Core on IIS

ASP.NET Core Module configuration reference

Development-time IIS support in Visual Studio for ASP.NET Core

IIS Modules with ASP.NET Core

Host in a Windows service

Host on Linux with Nginx

Host on Linux with Apache

Host in Docker

Build Docker images

Visual Studio Tools for Docker

Publish to a Docker image

Proxy and load balancer configuration

Visual Studio publish profiles

Directory structure

Common errors reference for Azure App Service and IIS

Security

Authentication

Introduction to Identity

Scaffold Identity

Add custom user data to Identity

Community OSS authentication options

Configure Identity

Configure Windows Authentication

Configure primary key type for Identity

Custom storage providers for Identity

Enable authentication using Facebook, Google, and other external providers

Facebook authentication

Twitter authentication

Google authentication

Microsoft authentication

Other authentication providers

WS-Federation authentication

Account confirmation and password recovery

Enable QR code generation in Identity

Two-factor authentication with SMS

Azure Active Directory

Integrate Azure AD Into an ASP.NET Core web app

Integrate Azure AD B2C into a customer-facing ASP.NET Core web app

Integrate Azure AD B2C into an ASP.NET Core web API

Call a ASP.NET Core Web API from a WPF app using Azure AD

Call a Web API in an ASP.NET Core web app using Azure AD

Secure ASP.NET Core apps with IdentityServer4

Secure ASP.NET Core apps with Azure App Service authentication (Easy Auth)

Individual user accounts

Authorization

Introduction

Create an app with user data protected by authorization

Razor Pages authorization

Simple authorization

Role-based authorization

Claims-based authorization

Policy-based authorization

Authorization policy providers

Dependency injection in requirement handlers

Resource-based authorization

View-based authorization

Limit identity by scheme

Data protection

Introduction to data protection

Get started with the Data Protection APIs

Consumer APIs

Consumer APIs overview

Purpose strings

Purpose hierarchy and multi-tenancy

Hash passwords

Limit the lifetime of protected payloads

Unprotect payloads whose keys have been revoked

Configuration

Configure data protection

Default settings

Machine-wide policy

Non-DI aware scenarios

Extensibility APIs

Core cryptography extensibility

Key management extensibility

Miscellaneous APIs

Implementation

Authenticated encryption details

Subkey derivation and authenticated encryption

Context headers

Key management

Key storage providers

Key encryption at rest

Key immutability and settings

Key storage format

Ephemeral data protection providers

Compatibility

Replace in ASP.NET

Enforce HTTPS

EU General Data Protection Regulation (GDPR) support

Safe storage of app secrets in development

Azure Key Vault configuration provider

Anti-request forgery

Prevent open redirect attacks

Prevent Cross-Site Scripting

Enable Cross-Origin Requests (CORS)

Performance

Cache responses

Cache in-memory

Work with a distributed cache

Response caching

Response caching middleware

Response compression middleware

Migration

ASP.NET Core 2.0 to 2.1

ASP.NET to ASP.NET Core

MVC

Web API

Configuration

Authentication and Identity

ClaimsPrincipal.Current

Membership to Identity

HTTP modules to middleware

ASP.NET Core 1.x to 2.0

Authentication and Identity

API reference

Contribute