AspNetCore.Docs/aspnet/index.md

718 lines
47 KiB
Markdown

---
uid: index
layout: HubPage
ms.topic: hub-page
title: ASP.NET Documentation | Microsoft Docs
description:
---
<div id="main" class="v2">
<div class="container">
<h1>ASP.NET Documentation</h1>
<ul class="pivots">
<li>
<a href="#core">ASP.NET Core</a>
<ul id="core">
<li>
<a href="#core_overview">Overview</a>
<ul id="core_overview" class="cardsC">
<li>
<div class="container intro">
<p>ASP.NET Core is a new open-source and cross-platform .NET framework for building modern
cloud-based web applications on Windows, Mac, or Linux.</p>
<p><a href="https://docs.microsoft.com/aspnet/core/choose-aspnet-framework" data-raw-source="[Learn the benefits of both ASP.NET Core and ASP.NET](https://docs.microsoft.com/aspnet/core/choose-aspnet-framework)">Learn the benefits of both ASP.NET Core and ASP.NET</a>
and choose the one that&#39;s right for you.</p>
</div>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/getting-started">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-overview-1.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Get started with ASP.NET Core</h3>
<p>Create your first ASP.NET Core app on any platform in 5 minutes.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-overview-2.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Introduction to ASP.NET Core</h3>
<p>Discover the new concepts in ASP.NET Core and how they help you develop
modern web apps.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/dotnet/api/?view=aspnetcore-2.0">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-overview-3.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>API Reference</h3>
<p>Explore the ASP.NET Core class library.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/mvc/overview">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-overview-4.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Overview of ASP.NET Core MVC</h3>
<p>Learn how to build web apps and APIs using the MVC design pattern.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/fundamentals/">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-overview-5.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Fundamentals</h3>
<p>Learn the fundamentals of ASP.NET Core.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://www.asp.net/freecourses">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-overview-6.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Free Courses</h3>
<p>Learn to build apps with ASP.NET Core from various training providers
for free.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li class="fullSpan">
<div class="container footer">
<p><a href="https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md">Contribute to ASP.NET Core docs and samples</a></p>
<p><a href="https://docs.microsoft.com/dotnet/articles/project-json">Find Visual Studio 2015/project.json version of the documentation</a></p>
</div>
</li>
</ul>
</li>
<li>
<a href="#core_tutorials">Tutorials</a>
<ul id="core_tutorials" class="cardsZ">
<li>
<div class="container intro">
<p>Featured tutorials | <a href="https://docs.microsoft.com/aspnet/core/tutorials/" data-raw-source="[View all ASP.NET Core tutorials](https://docs.microsoft.com/aspnet/core/tutorials/)">View all ASP.NET Core tutorials</a></p>
</div>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/tutorials/first-mvc-app-mac/start-mvc">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-tutorials-1.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Build a website on a Mac</h3>
<p>Build your first ASP.NET core app on a Mac using Visual Studio for Mac.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/tutorials/first-mvc-app/">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-tutorials-2.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Build a website with Visual Studio on Windows</h3>
<p>Build your first ASP.NET Core MVC app with Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/tutorials/first-web-api">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-tutorials-3.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Build a web API</h3>
<p>Build your first web API with ASP.NET Core MVC and Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/data/ef-mvc/">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-tutorials-4.svg" alt=""
/>
</div>
</div>
<div class="cardText">
<h3>Get started with Entity Framework Core and ASP.NET Core</h3>
<p>Create ASP.NET Core MVC web applications that use Entity Framework Core
for data access.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/tutorials/web-api-help-pages-using-swagger">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-tutorials-5.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>ASP.NET Web API Help Pages using Swagger</h3>
<p>Generate documentation and help pages for ASP.NET Web API using Swagger
and Swashbuckle.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/core/tutorials/publish-to-azure-webapp-using-vs">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/core-tutorials-6.svg" alt=""
/>
</div>
</div>
<div class="cardText">
<h3>Deploy an ASP.NET Core web app to Azure using Visual Studio</h3>
<p>Create a web app in Azure App Service and deploy an ASP.NET Core web
app to it.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li class="fullSpan">
<div class="container footer">
<p><a href="https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md">Contribute to ASP.NET Core docs and samples</a></p>
<p><a href="https://docs.microsoft.com/dotnet/articles/project-json">Find Visual Studio 2015/project.json version of the documentation</a></p>
</div>
</li>
</ul>
</li>
</ul>
</li>
<li>
<a href="#aspnet">ASP.NET</a>
<ul id="aspnet">
<li>
<a href="#aspnet_overview">Overview</a>
<ul id="aspnet_overview" class="cardsC">
<li>
<div class="container intro">
<p>ASP.NET is a mature web platform that provides all the services that you require to build
enterprise-class server-based web applications using .NET on Windows.</p>
<p><a href="https://docs.microsoft.com/aspnet/core/choose-aspnet-framework" data-raw-source="[Learn the benefits of both ASP.NET Core and ASP.NET](https://docs.microsoft.com/aspnet/core/choose-aspnet-framework)">Learn the benefits of both ASP.NET Core and ASP.NET</a>
and choose the one that&#39;s right for you.</p>
</div>
</li>
<li>
<a href="https://go.microsoft.com/fwlink/?LinkId=826064">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-1.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Download Visual Studio</h3>
<p>Visual Studio is a free IDE for ASP.NET on Windows.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/overview">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-2.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Introduction to ASP.NET</h3>
<p>Compare the ASP.NET technologies for building web applications and web
APIs, and for adding real-time functionality.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/api-ref">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-3.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>ASP.NET API reference</h3>
<p>Explore the ASP.NET class library.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/mvc/overview/getting-started/introduction/getting-started">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-4.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Websites</h3>
<p>Learn how to build a website using ASP.NET MVC 5 and Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/web-api/overview/getting-started-with-aspnet-web-api/tutorial-your-first-web-api">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-5.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Web APIs</h3>
<p>Learn how to build a Web API using ASP.NET Web API 2 and Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/signalr/overview/getting-started/tutorial-getting-started-with-signalr">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-6.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Real-time</h3>
<p>Lean how to build a chat application using ASP.NET SignalR 2 and Visual
Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://www.asp.net/freecourses">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-overview-7.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Free Courses</h3>
<p>Learn to build applications with ASP.NET from various training providers
for free.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li class="fullSpan">
<div class="container footer">
<p><a href="https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md">Contribute to ASP.NET docs and samples</a></p>
</div>
</li>
</ul>
</li>
<li>
<a href="#aspnet_framework">Frameworks</a>
<ul id="aspnet_framework" class="cardsC">
<li>
<div class="container intro">
<p><a href="/aspnet/overview#websites-and-web-applications">Learn about the different options for building websites with ASP.NET</a> and choose the one that&#39;s right for you.</p>
</div>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/web-forms">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-framework-1.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Web Forms</h3>
<p>Build dynamic websites using a familiar drag-and-drop, event-driven model.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/mvc">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-framework-2.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>MVC</h3>
<p>A powerful, patterns-based way to build dynamic websites that enables
a clean separation of concerns.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/web-pages">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-framework-3.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Web Pages</h3>
<p>A fast, approachable, and lightweight way to combine server code with
HTML to create dynamic web content.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/web-api">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-framework-4.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Web API</h3>
<p>Easily build HTTP services that reach a broad range of clients, including
browsers and mobile devices.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/webhooks">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-framework-5.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>WebHooks</h3>
<p>Wire together Web APIs and SaaS services using a lightweight HTTP pattern
providing a simple pub/sub model.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/signalr">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-framework-6.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>SignalR</h3>
<p>Add real-time web functionality to your applications.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li class="fullSpan">
<div class="container footer">
<p><a href="https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md">Contribute to ASP.NET docs and samples</a></p>
</div>
</li>
</ul>
</li>
<li>
<a href="#aspnet_tutorials">Tutorials</a>
<ul id="aspnet_tutorials" class="cardsZ">
<li>
<div class="container intro">
<p>Featured tutorials | <a href="https://docs.microsoft.com/aspnet/tutorials/" data-raw-source="[View all ASP.NET tutorials](https://docs.microsoft.com/aspnet/tutorials/)">View all ASP.NET tutorials</a></p>
</div>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/mvc/overview/getting-started/introduction/getting-started">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-tutorials-1.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Getting Started with ASP.NET MVC 5</h3>
<p>This tutorial series will teach you the basics of building an ASP.NET
MVC 5 web app using Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/web-api/overview/getting-started-with-aspnet-web-api/tutorial-your-first-web-api">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-tutorials-2.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Getting Started with ASP.NET Web API 2</h3>
<p>This tutorial will teach you the basics of building a web API using ASP.NET
Web API 2 and Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<!-- <li>
<a href="https://docs.microsoft.com/aspnet/web-forms/overview/getting-started/getting-started-with-aspnet-45-web-forms/introduction-and-overview">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-tutorials-3.svg" alt=""
/>
</div>
</div>
<div class="cardText">
<h3>Getting Started with ASP.NET 4.5 Web Forms and Visual Studio 2013</h3>
<p>This tutorial series will teach you the basics of building an ASP.NET
Web Forms application using ASP.NET 4.5 and Visual Studio.</p>
</div>
</div>
</div>
</div>
</a>
</li> -->
<li>
<a href="https://docs.microsoft.com/aspnet/signalr/overview/getting-started/tutorial-getting-started-with-signalr">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-tutorials-4.svg" alt="" />
</div>
</div>
<div class="cardText">
<h3>Getting Started with SignalR 2</h3>
<p>This tutorial shows how to use SignalR to create a real-time chat application.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/mvc/overview/getting-started/getting-started-with-ef-using-mvc/">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-tutorials-5.svg" alt=""
/>
</div>
</div>
<div class="cardText">
<h3>Getting Started with Entity Framework 6 Code First using MVC 5</h3>
<p>The basics of using Entity Framework 6 to display and edit data in an
ASP.NET MVC 5 application.</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li>
<a href="https://docs.microsoft.com/aspnet/mvc/overview/deployment/docker-aspnetmvc">
<div class="cardSize">
<div class="cardPadding">
<div class="card">
<div class="cardImageOuter">
<div class="cardImage bgdAccent1">
<img src="/media/hubs/aspnet/aspnet-tutorials-5.svg" alt=""
/>
</div>
</div>
<div class="cardText">
<h3>Migrating ASP.NET MVC Applications to Windows Containers</h3>
<p>Learn how to take an existing ASP.NET MVC application and run it in a Windows Docker Container .</p>
</div>
</div>
</div>
</div>
</a>
</li>
<li class="fullSpan">
<div class="container footer">
<p><a href="https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md">Contribute to ASP.NET docs and samples</a></p>
</div>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>