AspNetCore.Docs/aspnet/index.md

717 lines
46 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
uid: index
layout: HubPage
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>[Learn the benefits of both ASP.NET Core and ASP.NET](https://docs.microsoft.com/aspnet/core/choose-aspnet-framework)
and choose the one that'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/en-us/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/en-us/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 | [View all ASP.NET Core tutorials](https://docs.microsoft.com/aspnet/core/tutorials/)</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/en-us/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>[Learn the benefits of both ASP.NET Core and ASP.NET](https://docs.microsoft.com/aspnet/core/choose-aspnet-framework)
and choose the one that'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 thats 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 | [View all ASP.NET tutorials](https://docs.microsoft.com/aspnet/tutorials/)</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>