Introduction to ASP.NET Core

1244 Pages·2017·20.96 MB·English

TTaabbllee ooff CCoonntteennttss
Introduction
Getting Started
Tutorials
Your first ASP.NET Core application on a Mac using Visual Studio Code
Building your first ASP.NET Core MVC app with Visual Studio
Building your first Web API with ASP.NET Core MVC using Visual Studio
Getting started with ASP.NET Core and Entity Framework Core using Visual Studio
Deploy an ASP.NET Core web app to Azure using Visual Studio
ASP.NET Core on Nano Server
ASP.NET Core and Azure Service Fabric
Creating backend services for native mobile applications
Developing ASP.NET Core applications using dotnet watch
ASP.NET Web API Help Pages using Swagger
Fundamentals
Application Startup
Middleware
Working with Static Files
Routing
URL Rewriting Middleware
Error Handling
Globalization and localization
Configuration
Logging
File Providers
Dependency Injection
Working with Multiple Environments
Hosting
Session and application state
Servers
Kestrel
ASP.NET Core Module
WebListener
Request Features
Open Web Interface for .NET (OWIN)
Choose between ASP.NET Core and ASP.NET
Choose between .NET Core and .NET Framework runtime
MVC
Building your first ASP.NET Core MVC app with Visual Studio
Getting started
Adding a controller
Adding a view
Adding a model
Working with SQL Server LocalDB
Controller methods and views
Adding Search
Adding a New Field
Adding Validation
Examining the Details and Delete methods
Building your first Web API with ASP.NET Core MVC
Getting started with ASP.NET Core MVC and Entity Framework Core
Getting started
Create, Read, Update, and Delete operations
Sorting, filtering, paging, and grouping
Migrations
Creating a complex data model
Reading related data
Updating related data
Handling concurrency conflicts
Inheritance
Advanced topics
Creating backend services for native mobile applications
Handling requests with controllers
Routing to controller actions
Model binding
Model validation
File uploads
Dependency injection into controllers
Testing controllers
Rendering HTML with views
Razor syntax
Layout
� HTML helpers
Tag helpers
Partial views
Dependency injection into views
View components
Building Web APIs
Building your first Web API with ASP.NET Core MVC using Visual Studio
ASP.NET Web API Help Pages using Swagger
Creating backend services for native mobile applications
Formatting response data
� Support resource updates with JSON patch
Filters
Areas
Advanced
Working with the Application Model
� Application parts
� Creating a Custom View Engine
Custom formatters
Testing
Unit testing
Integration testing
Testing controllers
Working with Data
Getting started with ASP.NET Core and Entity Framework Core using Visual Studio
ASP.NET Core with EF Core - new database
ASP.NET Core with EF Core - existing database
Getting Started with ASP.NET Core and Entity Framework 6
Azure Storage
Adding 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
Using Gulp
Using Grunt
Manage client-side packages with Bower
Building beautiful, responsive sites with Bootstrap
Knockout.js MVVM Framework
Using Angular for Single Page Applications (SPAs)
Styling applications with Less, Sass, and Font Awesome
Bundling and minification
� Working with a Content Delivery Network (CDN)
Building Projects with Yeoman
Using Browser Link
Mobile
Creating Backend Services for Native Mobile Applications
Publishing and Deployment
Publishing to IIS
How Web Publishing In Visual Studio Works
Deploy an ASP.NET Core web app to Azure using Visual Studio
Publishing to an Azure Web App with Continuous Deployment
� Publishing to a Windows Virtual Machine on Azure
Publish to a Docker Image
Publish to a Linux Production Environment using nginx
Use VSTS to Build and Publish to an Azure Web App with Continuous Deployment
Using Apache Web Server on CentOS as a reverse-proxy
Guidance for Hosting Providers
ASP.NET Core Module configuration reference
Directory structure
Servicing
Data Protection
Security
Authentication
Introduction to Identity
Enabling authentication using Facebook, Google and other external providers
Account Confirmation and Password Recovery
Two-factor authentication with SMS
� Supporting Third Party Clients using OAuth 2.0
Using Cookie Middleware without ASP.NET Core Identity
Azure Active Directory
Securing ASP.NET Core apps with IdentityServer4
Authorization
Introduction
Simple Authorization
Role based Authorization
Claims-Based Authorization
Custom Policy-Based Authorization
Dependency Injection in requirement handlers
Resource Based Authorization
View Based Authorization
Limiting identity by scheme
Data Protection
Introduction to Data Protection
Getting Started with the Data Protection APIs
Consumer APIs
Configuration
Extensibility APIs
Implementation
Compatibility
Safe storage of app secrets during development
Azure Key Vault configuration provider
� Enforcing SSL
� Anti-Request Forgery
� Preventing Open Redirect Attacks
Preventing Cross-Site Scripting
Enabling Cross-Origin Requests (CORS)
Performance
� Measuring Application Performance
Caching
In Memory Caching
Working with a Distributed Cache
Response Caching
Response Caching Middleware
Response Compression Middleware
Migration
Migrating From ASP.NET MVC to ASP.NET Core MVC
Migrating Configuration
Migrating Authentication and Identity
Migrating from ASP.NET Web API
Migrating HTTP Modules to Middleware
API Reference
Release notes
Contribute
Introduction to ASP.NET Core
3/3/2017 • 2 min to read • Edit on GitHub
By Daniel Roth, Rick Anderson, and Shaun Luttin
ASP.NET Core is a significant redesign of ASP.NET. This topic introduces the new concepts in ASP.NET Core and
explains how they help you develop modern web apps.
What is ASP.NET Core?
ASP.NET Core is a new open-source and cross-platform framework for building modern cloud based internet
connected applications, such as web apps, IoT apps and mobile backends. ASP.NET Core apps can run on .NET
Core or on the full .NET Framework. It was architected to provide an optimized development framework for apps
that are deployed to the cloud or run on-premises. It consists of modular components with minimal overhead, so
you retain flexibility while constructing your solutions. You can develop and run your ASP.NET Core apps cross-
platform on Windows, Mac and Linux. ASP.NET Core is open source at GitHub.
Why build ASP.NET Core?
The first preview release of ASP.NET came out almost 15 years ago as part of the .NET Framework. Since then
millions of developers have used it to build and run great web apps, and over the years we have added and
evolved many capabilities to it.
ASP.NET Core has a number of architectural changes that result in a much leaner and modular framework.
ASP.NET Core is no longer based on System.Web.dll. It is based on a set of granular and well factored NuGet
packages. This allows you to optimize your app to include just the NuGet packages you need. The benefits of a
smaller app surface area include tighter security, reduced servicing, improved performance, and decreased costs in
a pay-for-what-you-use model.
With ASP.NET Core you gain the following foundational improvements:
A unified story for building web UI and web APIs
Integration of modern client-side frameworks and development workflows
A cloud-ready environment-based configuration system
Built-in dependency injection
New light-weight and modular HTTP request pipeline
Ability to host on IIS or self-host in your own process
Built on .NET Core, which supports true side-by-side app versioning
Ships entirely as NuGet packages
New tooling that simplifies modern web development
Build and run cross-platform ASP.NET apps on Windows, Mac and Linux
Open source and community focused
Build web UI and web APIs using ASP.NET Core MVC
You can create well-factored and testable web apps that follow the Model-View-Controller (MVC) pattern.
See MVC and Testing.
You can build HTTP services that support multiple formats and have full support for content negotiation.
See Formatting Response Data
Razor provides a productive language to create Views
Tag Helpers enable server-side code to participate in creating and rendering HTML elements in Razor files
You can create HTTP services with full support for content negotiation using custom or built-in formatters
(JSON, XML)
Model Binding automatically maps data from HTTP requests to action method parameters
Model Validation automatically performs client and server side validation
Client-side development
ASP.NET Core is designed to integrate seamlessly with a variety of client-side frameworks, including AngularJS,
KnockoutJS and Bootstrap. See Client-Side Development for more details.
Next steps
For getting-started tutorials, see ASP.NET Core Tutorials
For in-depth introduction to ASP.NET Core concepts and architecture, see ASP.NET Core Fundamentals.
An ASP.NET Core app can use the .NET Core or .NET Framework runtime. For more information, see Choosing
between .NET Core and .NET Framework.
Getting Started with ASP.NET Core
3/3/2017 • 1 min to read • Edit on GitHub
1. Install .NET Core
2. Create a new .NET Core project:
mkdir aspnetcoreapp
cd aspnetcoreapp
dotnet new web
Note: This command requires or later.
.NET Core SDK 1.0.0 - RC4
3. Restore the packages:
dotnet restore
4. Run the app (the command will build the app when it's out of date):
dotnet run
dotnet run
5. Browse to
http://localhost:5000
Next steps
For more getting-started tutorials, see ASP.NET Core Tutorials
For an introduction to ASP.NET Core concepts and architecture, see ASP.NET Core Introduction and ASP.NET Core
Fundamentals.
An ASP.NET Core app can use the .NET Core or .NET Framework runtime. For more information, see Choosing
between .NET Core and .NET Framework.
Tutorials
3/3/2017 • 1 min to read • Edit on GitHub
The following step-by-step guides for developing ASP.NET Core applications are available:
Building web applications
Your first ASP.NET Core application on a Mac using Visual Studio Code
Building your first ASP.NET Core MVC app with Visual Studio
Getting started with ASP.NET Core and Entity Framework Core using Visual Studio
Building projects with Yeoman
Authoring Tag Helpers
Creating a simple view component
Developing ASP.NET Core applications using dotnet watch
Building web APIs
Building your first web API with ASP.NET Core MVC and Visual Studio
ASP.NET Web API Help Pages using Swagger
Creating backend web services for native mobile applications
Working with data
Getting started with ASP.NET Core and Entity Framework Core using Visual Studio
ASP.NET Core with EF Core - new database
ASP.NET Core with EF Core - existing database
Authentication and authorization
Enabling authentication using Facebook, Google and other external providers
Account Confirmation and Password Recovery
Two-factor authentication with SMS
Client-side development
Using Gulp
Using Grunt
Manage client-side packages with Bower
Building beautiful, responsive sites with Bootstrap
Testing
Unit Testing in .NET Core using dotnet test
Publishing and deployment
Deploy an ASP.NET Core web app to Azure using Visual Studio
Publishing to an Azure Web App with Continuous Deployment