299 lines
19 KiB
Markdown
299 lines
19 KiB
Markdown
# [Introduction](index.md)
|
|
|
|
# [Getting Started](getting-started.md)
|
|
## [Create a Web app](xref:mvc/razor-pages/index)
|
|
## [Create a Web API](xref:tutorials/first-web-api)
|
|
|
|
# [Tutorials](tutorials/index.md)
|
|
# [Fundamentals](fundamentals/index.md)
|
|
## [Application Startup](fundamentals/startup.md)
|
|
## [Middleware](fundamentals/middleware.md)
|
|
## [Working with Static Files](fundamentals/static-files.md)
|
|
## [Routing](fundamentals/routing.md)
|
|
## [URL Rewriting Middleware](fundamentals/url-rewriting.md)
|
|
## [Error Handling](fundamentals/error-handling.md)
|
|
## [WebSockets](fundamentals/websockets.md)
|
|
## [Globalization and localization](fundamentals/localization.md)
|
|
## [Configuration](fundamentals/configuration.md)
|
|
## [Logging](fundamentals/logging.md)
|
|
## [File Providers](fundamentals/file-providers.md)
|
|
## [Dependency Injection](fundamentals/dependency-injection.md)
|
|
## [Working with Multiple Environments](fundamentals/environments.md)
|
|
## [Hosting](fundamentals/hosting.md)
|
|
## [Session and application state](fundamentals/app-state.md)
|
|
## [Servers](fundamentals/servers/index.md)
|
|
### [Kestrel](fundamentals/servers/kestrel.md)
|
|
### [ASP.NET Core Module](fundamentals/servers/aspnet-core-module.md)
|
|
### [WebListener](fundamentals/servers/weblistener.md)
|
|
### [HTTP.sys](fundamentals/servers/httpsys.md)
|
|
## [Request Features](fundamentals/request-features.md)
|
|
## [Open Web Interface for .NET (OWIN)](fundamentals/owin.md)
|
|
## [Choose between ASP.NET Core and ASP.NET](choose-aspnet-framework.md)
|
|
## [Choose between .NET Core and .NET Framework runtime](https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server)
|
|
## [Microsoft.AspNetCore.All metapackage](xref:fundamentals/metapackage)
|
|
|
|
# [MVC](mvc/overview.md)
|
|
## [Razor Pages](xref:mvc/razor-pages/index)
|
|
### [Razor syntax](mvc/views/razor.md)
|
|
## [Model Binding](mvc/models/model-binding.md)
|
|
### [Model validation](mvc/models/validation.md)
|
|
## [Views](mvc/views/overview.md)
|
|
### [Razor syntax](mvc/views/razor.md)
|
|
### [View compilation](mvc/views/view-compilation.md)
|
|
### [Layout](mvc/views/layout.md)
|
|
### [Tag helpers](mvc/views/tag-helpers/intro.md)
|
|
#### [Authoring tag helpers](mvc/views/tag-helpers/authoring.md)
|
|
#### [Using tag helpers in forms](mvc/views/working-with-forms.md)
|
|
|
|
#### [Built-in tag helpers](mvc/views/tag-helpers/built-in/index.md)
|
|
##### [Anchor tag helper](mvc/views/tag-helpers/built-in/AnchorTagHelper.md)
|
|
##### [Cache tag helper](mvc/views/tag-helpers/built-in/CacheTagHelper.md)
|
|
##### [Distributed Cache tag helper](mvc/views/tag-helpers/built-in/DistributedCacheTagHelper.md)
|
|
##### [Environment tag helper](mvc/views/tag-helpers/built-in/EnvironmentTagHelper.md)
|
|
##### [Image tag helper](mvc/views/tag-helpers/built-in/ImageTagHelper.md)
|
|
|
|
### [Partial views](mvc/views/partial.md)
|
|
### [Dependency injection into views](mvc/views/dependency-injection.md)
|
|
### [View components](mvc/views/view-components.md)
|
|
## [Controllers](mvc/controllers/actions.md)
|
|
### [Routing to controller actions](mvc/controllers/routing.md)
|
|
### [File uploads](mvc/models/file-uploads.md)
|
|
### [Dependency injection into controllers](mvc/controllers/dependency-injection.md)
|
|
### [Testing controllers](mvc/controllers/testing.md)
|
|
|
|
## [Advanced](mvc/advanced/index.md)
|
|
### [Working with the Application Model](mvc/controllers/application-model.md)
|
|
### [Filters](mvc/controllers/filters.md)
|
|
### [Areas](mvc/controllers/areas.md)
|
|
### [Application parts](mvc/advanced/app-parts.md)
|
|
### [Custom Model Binding](mvc/advanced/custom-model-binding.md)
|
|
### [Custom formatters](mvc/advanced/custom-formatters.md)
|
|
### [Formatting response data](mvc/models/formatting.md)
|
|
|
|
## [Tutorials](tutorials/index.md)
|
|
|
|
### [Create a Razor Pages web app](xref:tutorials/razor-pages/index)
|
|
#### [Getting started with Razor Pages](xref:tutorials/razor-pages/razor-pages-start)
|
|
#### [Adding a model](xref:tutorials/razor-pages/modelz)
|
|
#### [Scaffolded Razor Pages](xref:tutorials/razor-pages/page)
|
|
#### [SQL Server LocalDB](xref:tutorials/razor-pages/sql)
|
|
#### [Updating the pages](xref:tutorials/razor-pages/da1)
|
|
#### [Adding search](xref:tutorials/razor-pages/search)
|
|
#### [Adding a new field](xref:tutorials/razor-pages/new-field)
|
|
#### [Adding validation](xref:tutorials/razor-pages/validation)
|
|
|
|
### [Create an MVC web app on Windows](tutorials/first-mvc-app/index.md)
|
|
#### [Getting started](tutorials/first-mvc-app/start-mvc.md)
|
|
#### [Adding a controller](tutorials/first-mvc-app/adding-controller.md)
|
|
#### [Adding a view](tutorials/first-mvc-app/adding-view.md)
|
|
#### [Adding a model](tutorials/first-mvc-app/adding-model.md)
|
|
#### [Working with SQL Server LocalDB](tutorials/first-mvc-app/working-with-sql.md)
|
|
#### [Controller methods and views](tutorials/first-mvc-app/controller-methods-views.md)
|
|
#### [Adding search](tutorials/first-mvc-app/search.md)
|
|
#### [Adding a New Field](tutorials/first-mvc-app/new-field.md)
|
|
#### [Adding Validation](tutorials/first-mvc-app/validation.md)
|
|
#### [Examining the Details and Delete methods](tutorials/first-mvc-app/details.md)
|
|
|
|
### [Create an MVC web app on a Mac](tutorials/first-mvc-app-mac/index.md)
|
|
#### [Getting started](tutorials/first-mvc-app-mac/start-mvc.md)
|
|
#### [Adding a controller](tutorials/first-mvc-app-mac/adding-controller.md)
|
|
#### [Adding a view](tutorials/first-mvc-app-mac/adding-view.md)
|
|
#### [Adding a model](tutorials/first-mvc-app-mac/adding-model.md)
|
|
#### [Working with SQLite](tutorials/first-mvc-app-mac/working-with-sql.md)
|
|
#### [Controller methods and views](tutorials/first-mvc-app-mac/controller-methods-views.md)
|
|
#### [Adding search](tutorials/first-mvc-app-mac/search.md)
|
|
#### [Adding a New Field](tutorials/first-mvc-app-mac/new-field.md)
|
|
#### [Adding Validation](tutorials/first-mvc-app-mac/validation.md)
|
|
#### [Examining the Details and Delete methods](tutorials/first-mvc-app/details.md)
|
|
|
|
### [Create an MVC web app with VS Code](tutorials/first-mvc-app-xplat/index.md)
|
|
#### [Getting started](tutorials/first-mvc-app-xplat/start-mvc.md)
|
|
#### [Adding a controller](tutorials/first-mvc-app-xplat/adding-controller.md)
|
|
#### [Adding a view](tutorials/first-mvc-app-xplat/adding-view.md)
|
|
#### [Adding a model](tutorials/first-mvc-app-xplat/adding-model.md)
|
|
#### [Working with SQLite](tutorials/first-mvc-app-xplat/working-with-sql.md)
|
|
#### [Controller methods and views](tutorials/first-mvc-app-xplat/controller-methods-views.md)
|
|
#### [Adding search](tutorials/first-mvc-app-xplat/search.md)
|
|
#### [Adding a New Field](tutorials/first-mvc-app-xplat/new-field.md)
|
|
#### [Adding Validation](tutorials/first-mvc-app-xplat/validation.md)
|
|
#### [Examining the Details and Delete methods](tutorials/first-mvc-app/details.md)
|
|
|
|
### [Create a Razor Pages web app on a Mac](xref:tutorials/razor-pages-mac/index)
|
|
#### [Getting started with Razor Pages](xref:tutorials/razor-pages-mac/razor-pages-start)
|
|
#### [Adding a model](xref:tutorials/razor-pages-mac/model)
|
|
|
|
|
|
### [Create a Razor Pages web app with VS Code](xref:tutorials/razor-pages-vsc/index)
|
|
#### [Getting started with Razor Pages](xref:tutorials/razor-pages-vsc/razor-pages-start)
|
|
#### [Adding a model](xref:tutorials/razor-pages-vsc/model)
|
|
|
|
|
|
### [Data access - working with EF Core](data/ef-mvc/index.md)
|
|
#### [Getting started](data/ef-mvc/intro.md)
|
|
#### [Create, Read, Update, and Delete operations](data/ef-mvc/crud.md)
|
|
#### [Sorting, filtering, paging, and grouping](data/ef-mvc/sort-filter-page.md)
|
|
#### [Migrations](data/ef-mvc/migrations.md)
|
|
#### [Creating a complex data model](data/ef-mvc/complex-data-model.md)
|
|
#### [Reading related data](data/ef-mvc/read-related-data.md)
|
|
#### [Updating related data](data/ef-mvc/update-related-data.md)
|
|
#### [Handling concurrency conflicts](data/ef-mvc/concurrency.md)
|
|
#### [Inheritance](data/ef-mvc/inheritance.md)
|
|
#### [Advanced topics](data/ef-mvc/advanced.md)
|
|
### [Creating backend services for mobile apps](mobile/native-mobile-backend.md)
|
|
### [Building Web APIs](mvc/web-api/index.md)
|
|
### [Create a Web API](xref:tutorials/first-web-api-mac)
|
|
#### [ASP.NET Web API Help Pages using Swagger](tutorials/web-api-help-pages-using-swagger.md)
|
|
#### [Creating backend services for native mobile applications](mobile/native-mobile-backend.md)
|
|
|
|
# [Testing and debugging](testing/index.md)
|
|
## [Unit testing](https://docs.microsoft.com/dotnet/articles/core/testing/unit-testing-with-dotnet-test)
|
|
## [Integration testing](testing/integration-testing.md)
|
|
## [Testing controllers](mvc/controllers/testing.md)
|
|
## [Remote debugging](https://docs.microsoft.com/visualstudio/debugger/remote-debugging-azure)
|
|
|
|
# [Working with Data](data/index.md)
|
|
## [Getting started with ASP.NET Core and Entity Framework Core using Visual Studio](data/ef-mvc/index.md)
|
|
## [ASP.NET Core with EF Core - new database](https://docs.microsoft.com/ef/core/get-started/aspnetcore/new-db)
|
|
## [ASP.NET Core with EF Core - existing database](https://docs.microsoft.com/ef/core/get-started/aspnetcore/existing-db)
|
|
## [Getting Started with ASP.NET Core and Entity Framework 6](data/entity-framework-6.md)
|
|
## [Azure Storage](data/azure-storage/index.md)
|
|
### [Adding Azure Storage by using Visual Studio Connected Services](https://azure.microsoft.com/documentation/articles/vs-azure-tools-connected-services-storage)
|
|
### [Get started with Blob storage and Visual Studio Connected Services](https://azure.microsoft.com/documentation/articles/vs-storage-aspnet5-getting-started-blobs)
|
|
### [Get Started with Queue Storage and Visual Studio Connected Services](https://azure.microsoft.com/documentation/articles/vs-storage-aspnet5-getting-started-queues)
|
|
### [Get Started with Table Storage and Visual Studio Connected Services](https://azure.microsoft.com/documentation/articles/vs-storage-aspnet5-getting-started-tables)
|
|
|
|
# [Client-Side Development](xref:client-side/index)
|
|
## [Using Gulp](xref:client-side/using-gulp)
|
|
## [Using Grunt](xref:client-side/using-grunt)
|
|
## [Manage client-side packages with Bower](xref:client-side/bower)
|
|
## [Building beautiful, responsive sites with Bootstrap](xref:client-side/bootstrap)
|
|
## [Knockout.js MVVM Framework](xref:client-side/knockout)
|
|
## [Using AngularJS for Single Page Apps](xref:client-side/angular)
|
|
## [Using JavaScriptServices for Single Page Apps](xref:client-side/spa-services)
|
|
## [Styling applications with Less, Sass, and Font Awesome](xref:client-side/less-sass-fa)
|
|
## [Bundling and minification](xref:client-side/bundling-and-minification)
|
|
## [Building Projects with Yeoman](xref:client-side/yeoman)
|
|
## [Using Browser Link](xref:client-side/using-browserlink)
|
|
|
|
# [Mobile](xref:mobile/index)
|
|
# [Creating Backend Services for Native Mobile Applications](xref:mobile/native-mobile-backend)
|
|
|
|
# [Hosting and deployment](xref:publishing/index)
|
|
## [Host on Windows with IIS](xref:publishing/iis)
|
|
### [ASP.NET Core Module Configuration Reference](xref:hosting/aspnet-core-module)
|
|
### [IIS Modules with ASP.NET Core](xref:hosting/iis-modules)
|
|
## [Host in a Windows service](xref:hosting/windows-service)
|
|
## [Host on Linux with Nginx](xref:publishing/linuxproduction)
|
|
## [Host on Linux with Apache](xref:publishing/apache-proxy)
|
|
## [Host in Docker](xref:publishing/docker)
|
|
### [Building Docker Images](https://docs.microsoft.com/dotnet/articles/core/docker/building-net-docker-images)
|
|
### [Visual Studio Tools for Docker](https://docs.microsoft.com/dotnet/articles/core/docker/visual-studio-tools-for-docker)
|
|
### [Publish to a Docker Image](https://azure.microsoft.com/documentation/articles/vs-azure-tools-docker-hosting-web-apps-in-docker)
|
|
## [Publish to Azure with Visual Studio](xref:tutorials/publish-to-azure-webapp-using-vs)
|
|
## [Continuous deployment to Azure with Visual Studio and Git](xref:publishing/azure-continuous-deployment)
|
|
## [Continuous deployment to Azure with VSTS](https://www.visualstudio.com/en-us/docs/build/aspnet/core/quick-to-azure)
|
|
## [Publish profiles in Visual Studio](xref:publishing/web-publishing-vs)
|
|
## [Directory structure](xref:hosting/directory-structure)
|
|
|
|
# [Security](xref:security/index)
|
|
## [Authentication](xref:security/authentication/index)
|
|
### [Community OSS authentication options](xref:security/authentication/community)
|
|
### [Introduction to Identity](xref:security/authentication/identity)
|
|
### [Configure Identity](xref:security/authentication/identity-configuration)
|
|
### [Configure Windows Authentication](xref:security/authentication/windowsauth)
|
|
### [Configure primary key type for Identity](xref:security/authentication/identity-primary-key-configuration)
|
|
### [Custom storage providers for ASP.NET Core Identity](xref:security/authentication/identity-custom-storage-providers)
|
|
### [Enabling authentication using Facebook, Google and other external providers](xref:security/authentication/social/index)
|
|
#### [Facebook authentication](xref:security/authentication/facebook-logins)
|
|
#### [Twitter authentication](xref:security/authentication/twitter-logins)
|
|
#### [Google authentication](xref:security/authentication/google-logins)
|
|
#### [Microsoft authentication](xref:security/authentication/microsoft-logins)
|
|
#### [Other authentication providers](xref:security/authentication/otherlogins)
|
|
### [Account Confirmation and Password Recovery](xref:security/authentication/accconfirm)
|
|
### [Enabling QR Code generation in ASP.NET identity](xref:security/authentication/identity-enable-qrcodes)
|
|
### [Two-factor authentication with SMS](xref:security/authentication/2fa)
|
|
### [Using Cookie Authentication without ASP.NET Core Identity](xref:security/authentication/cookie)
|
|
### [Azure Active Directory](xref:security/authentication/azure-active-directory/index)
|
|
#### [Integrating Azure AD Into an ASP.NET Core Web App](https://azure.microsoft.com/documentation/samples/active-directory-dotnet-webapp-openidconnect-aspnetcore)
|
|
#### [Calling a ASP.NET Core Web API From a WPF Application Using Azure AD](https://azure.microsoft.com/documentation/samples/active-directory-dotnet-native-aspnetcore)
|
|
#### [Calling a Web API in an ASP.NET Core Web Application Using Azure AD](https://azure.microsoft.com/documentation/samples/active-directory-dotnet-webapp-webapi-openidconnect-aspnetcore)
|
|
### [Securing ASP.NET Core apps with IdentityServer4](https://identityserver4.readthedocs.io)
|
|
## [Authorization](xref:security/authorization/index)
|
|
### [Introduction](xref:security/authorization/introduction)
|
|
### [Create an app with user data protected by authorization](xref:security/authorization/secure-data)
|
|
### [Simple Authorization](xref:security/authorization/simple)
|
|
### [Role based Authorization](xref:security/authorization/roles)
|
|
### [Claims-Based Authorization](xref:security/authorization/claims)
|
|
### [Custom Policy-Based Authorization](xref:security/authorization/policies)
|
|
### [Dependency Injection in requirement handlers](xref:security/authorization/dependencyinjection)
|
|
### [Resource Based Authorization](xref:security/authorization/resourcebased)
|
|
### [View Based Authorization](xref:security/authorization/views)
|
|
### [Limiting identity by scheme](xref:security/authorization/limitingidentitybyscheme)
|
|
## [Data Protection](xref:security/data-protection/index)
|
|
### [Introduction to Data Protection](xref:security/data-protection/introduction)
|
|
### [Getting Started with the Data Protection APIs](xref:security/data-protection/using-data-protection)
|
|
### [Consumer APIs](xref:security/data-protection/consumer-apis/index)
|
|
####[Consumer APIs Overview](xref:security/data-protection/consumer-apis/overview)
|
|
####[Purpose Strings](xref:security/data-protection/consumer-apis/purpose-strings)
|
|
####[Purpose hierarchy and multi-tenancy](xref:security/data-protection/consumer-apis/purpose-strings-multitenancy)
|
|
####[Password Hashing](xref:security/data-protection/consumer-apis/password-hashing)
|
|
####[Limiting the lifetime of protected payloads](xref:security/data-protection/consumer-apis/limited-lifetime-payloads)
|
|
####[Unprotecting payloads whose keys have been revoked](xref:security/data-protection/consumer-apis/dangerous-unprotect)
|
|
###[Configuration](xref:security/data-protection/configuration/index)
|
|
####[Configuring Data Protection](xref:security/data-protection/configuration/overview)
|
|
####[Default Settings](xref:security/data-protection/configuration/default-settings)
|
|
####[Machine Wide Policy](xref:security/data-protection/configuration/machine-wide-policy)
|
|
####[Non DI Aware Scenarios](xref:security/data-protection/configuration/non-di-scenarios)
|
|
###[Extensibility APIs](xref:security/data-protection/extensibility/index)
|
|
####[Core cryptography extensibility](xref:security/data-protection/extensibility/core-crypto)
|
|
####[Key management extensibility](xref:security/data-protection/extensibility/key-management)
|
|
####[Miscellaneous APIs](xref:security/data-protection/extensibility/misc-apis)
|
|
###[Implementation](xref:security/data-protection/implementation/index)
|
|
####[Authenticated encryption details.](xref:security/data-protection/implementation/authenticated-encryption-details)
|
|
####[Subkey Derivation and Authenticated Encryption](xref:security/data-protection/implementation/subkeyderivation)
|
|
####[Context headers](xref:security/data-protection/implementation/context-headers)
|
|
####[Key Management](xref:security/data-protection/implementation/key-management)
|
|
####[Key Storage Providers](xref:security/data-protection/implementation/key-storage-providers)
|
|
####[Key Encryption At Rest](xref:security/data-protection/implementation/key-encryption-at-rest)
|
|
####[Key Immutability and Changing Settings](xref:security/data-protection/implementation/key-immutability)
|
|
####[Key Storage Format](xref:security/data-protection/implementation/key-storage-format)
|
|
####[Ephemeral data protection providers](xref:security/data-protection/implementation/key-storage-ephemeral)
|
|
###[Compatibility](xref:security/data-protection/compatibility/index)
|
|
####[Sharing cookies between applications](xref:security/data-protection/compatibility/cookie-sharing)
|
|
####[Replacing <machineKey> in ASP.NET](xref:security/data-protection/compatibility/replacing-machinekey)
|
|
## [Enforcing SSL](xref:security/enforcing-ssl)
|
|
## [Setting up HTTPS for development](xref:security/https)
|
|
## [Safe storage of app secrets during development](xref:security/app-secrets)
|
|
## [Azure Key Vault configuration provider](xref:security/key-vault-configuration)
|
|
## [Anti-Request Forgery](xref:security/anti-request-forgery)
|
|
## [Preventing Open Redirect Attacks](xref:security/preventing-open-redirects)
|
|
## [Preventing Cross-Site Scripting](xref:security/cross-site-scripting)
|
|
## [Enabling Cross-Origin Requests](xref:security/cors)
|
|
|
|
# [Performance](xref:performance/index)
|
|
## [Caching](xref:performance/caching/index)
|
|
### [In-Memory Caching](xref:performance/caching/memory)
|
|
### [Working with a Distributed Cache](xref:performance/caching/distributed)
|
|
### [Response Caching](xref:performance/caching/response)
|
|
### [Response Caching Middleware](xref:performance/caching/middleware)
|
|
## [Response Compression Middleware](xref:performance/response-compression)
|
|
|
|
# [Migration](xref:migration/index)
|
|
## [ASP.NET to ASP.NET Core 1.x](xref:migration/mvc)
|
|
### [Configuration](xref:migration/configuration)
|
|
### [Authentication and Identity](xref:migration/identity)
|
|
### [Web API](xref:migration/webapi)
|
|
### [HTTP Modules to Middleware](xref:migration/http-modules)
|
|
## [ASP.NET to ASP.NET Core 2.0](xref:migration/proper-to-2x/index)
|
|
## [ASP.NET Core 1.x to 2.0](xref:migration/1x-to-2x/index)
|
|
### [Authentication and Identity](xref:migration/1x-to-2x/identity-2x)
|
|
|
|
# [API Reference](/aspnet/core/api/)
|
|
|
|
# [2.0 release notes](aspnetcore-2.0.md)
|
|
## [1.1 Release notes](aspnetcore-1.1.md)
|
|
## [Earlier release notes](https://github.com/aspnet/home/releases)
|
|
## [VS 2015/project.json docs](https://docs.microsoft.com/dotnet/articles/project-json)
|
|
|
|
# [Contribute](https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md)
|