AspNetCore.Docs/aspnetcore/toc.md

25 KiB

Overview

About ASP.NET Core

Compare ASP.NET Core and ASP.NET

Compare .NET Core and .NET Framework

Get started

Tutorials

Web APIs

Create a web API

Web API with MongoDB

Web apps

Razor Pages

MVC

With Visual Studio

With Visual Studio Code

With Visual Studio for Mac

Real-time web apps

SignalR with JavaScript

SignalR with TypeScript

Create backend services for native mobile apps

Data access

EF Core with Razor Pages

EF Core with MVC, existing DB

EF Core with MVC, new DB

EF Core with MVC, long tutorial

Fundamentals

Overview

App startup

Dependency injection (services)

Routing

Environments (dev, stage, prod)

Configuration

Options

Logging

Handle errors

Middleware

Overview

Factory-based middleware

Factory-based middleware with third-party container

Host

Overview

Web Host

Generic Host

Servers

Overview

Kestrel

ASP.NET Core Module

HTTP.sys

Initiate HTTP requests

Web apps

Razor Pages

Overview

Razor Pages tutorial

Get started

Add a model

Scaffolding

Work with a DB

Update the pages

Add a new field

Add validation

Filters

Razor Class Libraries

Route and app conventions

Upload files

Razor SDK

MVC

Overview

Tutorials

MVC with Visual Studio

Overview
Get started
Add a controller
Add a view
Add a model
Work with a DB
Controller actions and views
Add a new field
Add validation
Examine the Details and Delete methods

MVC with Visual Studio Code

Overview
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 with Visual Studio for Mac

Overview
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

Views

Partial views

Controllers

Routing

File uploads

Dependency injection - controllers

Dependency injection - views

Unit testing

Session and app state

Tag Helpers

Overview

Create Tag Helpers

Use Tag Helpers in forms

Tag Helper Components

Built-in Tag Helpers

Anchor

Cache

Distributed Cache

Environment

Form

Image

Input

Label

Partial

Select

Textarea

Validation Message

Validation Summary

Layout

Static files

Model binding

Model validation

Razor syntax

Advanced

View components

View compilation

App model

Filters

Areas

App parts

Custom model binding

Compatibility version

Web APIs

Overview

Tutorials

Create a web API

Web API with MongoDB

Swagger / OpenAPI

Overview

Get started with Swashbuckle

Get started with NSwag

Action return types

Format response data

Custom formatters

Analyzers

Conventions

Real-time apps

SignalR overview

Supported platforms

Tutorials

SignalR with JavaScript

SignalR with TypeScript

Server concepts

Hubs

HubContext

Users and groups

Publish to Azure

API design considerations

Clients

.NET client

.NET API reference

Java client

Java API reference

JavaScript client

JavaScript API reference

Hosting and scaling

Overview

Azure SignalR Service

Redis backplane

Configuration

Authentication and authorization

Security considerations

MessagePack Hub Protocol

Streaming

Compare SignalR and SignalR Core

WebSockets without SignalR

Test, debug, and troubleshoot

Unit testing

Razor Pages unit tests

Test controllers

Remote debugging

Snapshot debugging

Snapshot debugging in Visual Studio

Integration tests

Troubleshoot

Data access

Tutorials

EF Core with Razor Pages

Overview

Get started

Create, Read, Update, and Delete

Sort, filter, page, and group

Migrations

Create a complex data model

Handle concurrency conflicts

EF Core with MVC, new DB

EF Core with MVC, existing DB

EF Core with MVC, long tutorial

Overview

Get started

Create, Read, Update, and Delete

Sort, filter, page, and group

Migrations

Create a complex data model

Handle concurrency conflicts

Inheritance

Advanced topics

EF 6 with ASP.NET Core

Azure Storage with Visual Studio

Connected Services

Blob storage

Queue storage

Table storage

Client-side development

Overview

Gulp

Grunt

LibMan

Overview

CLI

Visual Studio

Bower

LESS, Sass, and Font Awesome

Bundle and minify

Single Page Apps

Overview

Angular

React

React with Redux

JavaScriptServices

Hosting and deployment

Overview

Host on Azure App Service

Overview

Publish with Visual Studio

Publish with CLI tools

Publish with Visual Studio and Git

Continuous deployment with Azure Pipelines

Troubleshoot startup errors

DevOps

Overview

Tools and downloads

Deploy to App Service

Continuous integration and deployment

Monitor and troubleshoot

Next steps

Host on Windows with IIS

Overview

Troubleshoot on IIS

ASP.NET Core Module reference

IIS support in Visual Studio

IIS Modules

Host in a Windows service

Host on Linux with Nginx

Host on Linux with Apache

Host in Docker

Overview

Build Docker images

Visual Studio Tools

Publish to a Docker image

Proxy and load balancer configuration

Host in a web farm

Visual Studio publish profiles

Directory structure

Errors reference for Azure App Service and IIS

Health checks

Security and Identity

Overview

Authentication

Introduction to Identity

Scaffold Identity

Add custom user data to Identity

Customize Identity

Community OSS authentication options

Configure Identity

Configure Windows Authentication

Custom storage providers for Identity

External providers

Overview

Facebook authentication

Twitter authentication

Google authentication

Microsoft authentication

External authentication providers

Additional claims

WS-Federation authentication

Account confirmation and password recovery

Enable QR code generation in Identity

Two-factor authentication with SMS

Azure Active Directory

Overview

Integrate Azure AD into a web app

Integrate Azure AD B2C into a web app

Integrate Azure AD B2C into a web API

Call a web API from WPF

Call a web API in a 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

Overview

Create a web app with authorization

Razor Pages authorization conventions

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

Overview

Data Protection 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

Overview

Configure data protection

Default settings

Machine-wide policy

Non-DI aware scenarios

Extensibility APIs

Overview

Core cryptography extensibility

Key management extensibility

Miscellaneous APIs

Implementation

Overview

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

Overview

Replace in ASP.NET

Protect secrets in development

Enforce HTTPS

EU General Data Protection Regulation (GDPR) support

Azure Key Vault configuration provider

Anti-request forgery

Prevent open redirect attacks

Prevent Cross-Site Scripting

Enable Cross-Origin Requests (CORS)

IP safelist

Performance

Overview

Response caching

Overview

In-memory cache

Distributed caching

Response caching middleware

Response compression

Other topics

Globalization and localization

Portable Object localization with Orchard Core

URL rewriting

File providers

Request Features

Access HttpContext

Change tokens

Open Web Interface for .NET (OWIN)

Background tasks with hosted services

Hosting startup assemblies

Microsoft.AspNetCore.App metapackage

Microsoft.AspNetCore.All metapackage

Logging with LoggerMessage

Use a file watcher

Migration

2.1 to 2.2

2.0 to 2.1

1.x to 2.0

Overview

Authentication and Identity

ASP.NET to ASP.NET Core

Overview

MVC

Web API

Configuration

Authentication and Identity

ClaimsPrincipal.Current

Membership to Identity

HTTP modules to middleware

What's new

What's new in 2.2

What's new in 2.1

What's new in 2.0

What's new in 1.1

API reference

Contribute