.NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ......

74
.NET Core, ASP.NET Core, and ASP.NET Core MVC brave new world

Transcript of .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ......

Page 1: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

.NETCore,ASP.NETCore,andASP.NETCoreMVC

bravenewworld

Page 2: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Outline

• Motivation• .NETCore• ASP.NETCore• ASP.NETCoreMVC

Page 3: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Motivation

• .NEThasastronghistory• Verypopular• Lotsofinvestments

• ThereismorethanjustWindows• Manymoreplatforms,devices,andclouds

• .NETisevolving• .NETneedstolearntoruninmoreplaces• .NETneedsmoderntooling

Page 4: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

.NETruntimestargetaplatform

• .NETFramework• Windows-only

• .NETCore• Cross-platformruntime

• .NETNative(UWP)• Mono• WindowsPhone• More…

Page 5: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

.NETCore:nextgen.NETforserverapps

• Crossplatform• Windows,Linux,Mac,FreeBSD

• Portable• Canbe~/bindeployed• Canbeuserormachineinstalledaswell

• Opensource• https://github.com/dotnet/coreclr• Containscoreruntimeandmscorlib (e.g.GC,JIT,BCL)• Doesnotcontainmanyframeworks(e.g.WCF,WPF)

Page 6: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Developmentecosystem

• SDK• Command-linetooling(dotnet)

• Projectsystem• File-systembasedprojectsystem(project.json)

• Runtime,libraries,andpackaging• NuGet-focused

• Editors/IDEs• Anytexteditor(VSCode,Emacs,Sublime,etc)andOmniSharp (OSS)• VisualStudio(Microsoft)• ProjectRider(JetBrains)

Page 7: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Installing.NETSDK

• Usenightlybuilds(untilRC2isreleased)• https://github.com/dotnet/cli

Page 8: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

dotnet :commandlinetool

• Createnewproject• InstallNuGetdependencies• Buildapplication• Load.NETandrunapplication• Packagelibrary• Publishapplication

Page 9: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

dotnet new

• Createsnewproject• program.cs• project.json

• Console-basedapplicationusing System;

namespace ConsoleApplication{

public class Program{

public static void Main(string[] args){

Console.WriteLine("Hello World!");}

}}

Page 10: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

project.json

• Projecttype• Applicationorlibrary

• Dependencies• PrimarilyfromNuGet

• Targetframework(s)• Targetframeworkmoniker(TFM)

{"version": "1.0.0-*","buildOptions": {"emitEntryPoint": true

},"dependencies": {"Microsoft.AspNetCore.Mvc": "1.0.0-rc2-*"

},"frameworks": {"net46" : {},"netcoreapp1.0": {"dependencies": {

"Microsoft.NETCore.App": {"type": "platform","version": "1.0.0-rc2-3002659"

}}

}}

}

Page 11: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

.NETplatformstandard

• Identifier(TFM)forrequiredframework• ReplacementforPCLplatformversioningnightmare

• LibrariestargetanexpectedAPIfromframework• "netstandard1.0","netstandard1.1",…,"netstandard1.5"• Canuselibrariesfromearlier.NETStandardversion

• Applicationstargetaspecificplatform(andthusframework)• "net451","net452","net46","net461","netcoreapp1.0",etc…• Platformssupportaspecific.NETStandardversion

https://github.com/dotnet/corefx/blob/master/Documentation/architecture/net-platform-standard.md

Page 12: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Platformsupportfor.NETStandard

Page 13: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

dotnet restore

• DownloadsNuGet dependencies• Mightneedalocalnuget.config totargetnightlybuildsfrommyget.org

• Buildsproject.json.lock• Snapshotofdependencyversions• Neededtoloadapplication

<?xml version="1.0" encoding="utf-8"?><configuration><packageSources>

<!--To inherit the global NuGet package sources remove the <clear/> line below --><clear /><add key="dotnet-core" value="https://dotnet.myget.org/F/dotnet-core/api/v3/index.json" /><add key="AspNetCI" value="https://www.myget.org/F/aspnetcirelease/api/v3/index.json" />

</packageSources></configuration>

Page 14: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

dotnet build/dotnet run/dotnet app.dll

• Buildsproject,orbuildsandrunsapplication• -cindicatesconfiguration(release/debug)• -findicatesframeworktotarget• -vemitsverboselogoutput

• Binariesoutputto~/bin/<configuration>/<framework> folder

Page 15: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

ASP.NETCore

• Thenew pipeline• Middleware• Dependency Injection• Configuration

Page 16: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Motivation

• Modernwebstack• Modernpackagesystem(NuGet)• Lightweight/composable runtime• Dependencyinjection• Flexibleconfiguration/deployment

Page 17: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core
Page 18: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

"EmptyWebApplication"

Page 19: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core
Page 20: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

OWINMiddlewareArchitecture

• Middlewarearelinkedcomponentsthatprocessrequests• Applicationcodetargetingaframework

Host

OWINServer

SomeMiddleware

SomeOtherMiddlewareUserAgent Application

Page 21: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

ASP.NETCore

• ASP.NETCoreisHTTPpipelineimplementation• sitsontopof.NETCore• usesthemiddlewareconcept(butatahigherabstractionlevelthanOWIN)• comeswithitsownserver(Kestrel)• addsDItoprovideservices

• ASP.NETCoreMVCisMicrosoft'sapplicationframework

Host

.NETCore

ASP.NETCore

Middleware MiddlewareUserAgent MVC

DI

Page 22: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

How ASP.NETCoreApplications start

dotnet run

Application.dll

ASP.NETCoreModuleIIS

Startup.cs

ConfigureServices(…)

Configure(…)

startprocess

Page 23: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

LoadingASP.NETCorepublic class Program{

public static void Main(){

var host = new WebHostBuilder().UseKestrel().UseIISIntegration().UseStartup<Startup>().Build();

host.Run();}

}

public class Startup{

public void Configure(IApplicationBuilder app){

...}

}

Page 24: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

PipelineprimitivesStart

app.Use(context,next)

app.Map("/path")

app.Use(context,next)

app.Run(context)

app.Use(context,next)

app.Run(context)

Page 25: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Run

app.Run(async context =>{

await context.Response.WriteAsync("Hello ASP.NET Core");});

namespace Microsoft.AspNetCore.Builder{

public delegate Task RequestDelegate(HttpContext context);}

Page 26: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Map

app.Map("/hello", helloApp =>{

helloApp.Run(async (HttpContext context) =>{

await context.Response.WriteAsync("Hello ASP.NET Core");});

});

Page 27: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Use

app.Use(async (context, next) =>{

if (!context.Request.Path.Value.EndsWith("/favicon.ico")){

Console.WriteLine("pre");Console.WriteLine(context.Request.Path);

await next();

Console.WriteLine("post");Console.WriteLine(context.Response.StatusCode);

}else{

await next();}

});

Page 28: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Middlewareclasses

public class InspectionMiddleware{

private readonly RequestDelegate _next;

public InspectionMiddleware(RequestDelegate next){

_next = next;}

public async Task Invoke(HttpContext context){

Console.WriteLine($"request: {context.Request.Path}");await _next(context);

}}

app.UseMiddleware<InspectionMiddleware>();

Page 29: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Dependency Injection

• Various places• Configure• Middlewareclasses• Higher-levelframeworks (e.g.MVCcontroller)

• Hostprovided dependencies (e.g.IHostingEnvironment,ILoggerFactory)• Dependencies set up inConfigureServices

Page 30: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

DIExamples

public class Startup{

public Startup(IHostingEnvironment environment){ /* stuff */ }

public void ConfigureServices(IServiceCollection services){ /* register more stuff */ }

public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory){

/* add middleware */}

}

Page 31: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Registering dependencies

• Newinstance "percall"

• Newinstance perHTTPrequest

• Singleton

services.AddTransient<IMyCustomService, MyCustomService>();

services.AddSingleton<IMyCustomService, MyCustomService>();

services.AddScoped<IMyCustomService, MyCustomService>();

Page 32: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Configuration

• web.config is no more

• Newconfiguration system based onkey/value pairs• command line• environmentvariables• JSONfiles• INIfiles

• Configuration can come frommultiplesources• lastsource wins

Page 33: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Example

public class Startup{

public IConfiguration Configuration { get; set; }

public Startup(IHostingEnvironment env){

Configuration = new ConfigurationBuilder().SetBasePath(env.ContentRootPath).AddJsonFile("config.json").AddJsonFile($"config.{env.EnvironmentName}.json", optional: true).AddEnvironmentVariables().Build();

}

// more}

Page 34: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Usingconfigurationpublic class Startup{

IConfiguration _configuration;

public Startup(){

_configuration = new ConfigurationBuilder()....Build();

}

public void Configure(IApplicationBuilder app){

var copyright = new Copyright{

Company = _configuration.Get("copyright_company"),Year = _configuration.Get("copyright_year")

};

app.Run(async (context) =>{

await context.Response.WriteAsync($"Copyright {copyright.Year}, {copyright.Company}");});

}}

{"copyright": {

"year": "2015","company": "Foo Industries"

}}

Page 35: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

ASP.NETCoreMVC

• Packaging• Middleware• Routingandactionselection• Controllerinitialization• Modelbindingchanges• Razor• Filters• APIs• Errorhandling

Page 36: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Packaging

• MVCispackagedentirelyasaNuGet• Microsoft.AspNetCore.Mvc

{"dependencies": {

"Microsoft.AspNetCore.Mvc": "1.0.0-rc2-*","Microsoft.AspNetCore.Server.Kestrel": "1.0.0-rc2-*"

}}

Page 37: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Middleware

• MVCisconfiguredasmiddleware• InConfigureServices viaAddMvc• InConfigureviaUseMvc

public class Startup{

public void ConfigureServices(IServiceCollection services){

services.AddMvc();}

public void Configure(IApplicationBuilder app){

app.UseMvc();}

}

Page 38: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Overridingdefaultsettings

• Delegatecallbackparam usedtooverridedefaults• AlsofluentAPIonresultfromAddMvc()

public class Startup{

public void ConfigureServices(IServiceCollection services){

services.AddMvc(mvc =>{

mvc.Filters.Add(...);mvc.ViewEngines.Add(...);mvc.InputFormatters.Add(...);mvc.OutputFormatters.Add(...);

});}

}

Page 39: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Routing

• RoutesconfiguredviaUseMvc• RouteParameters.Optional fromMVC5removed

public void Configure(IApplicationBuilder app){

app.UseMvc(routes =>{

routes.MapRoute("old_default","{controller}/{action}",new {

controller = "Home", action="Index"});

routes.MapRoute("new_default","{controller=Home}/{action=Index}/{id?}");

});}

Page 40: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Controllers

• Controllerbaseclassstillprovided• ActionresultsnowimplementIActionResult• Controllerbaseprovidesmanyhelperstocreateactionresults

• View(),PartialView(),Content(),Json(),Ok(),Created(),HttpNotFound(),HttpUnauthorized(),HttpBadRequest(),File(),PhysicalFile(),Redirect(),RedirectPermanent()

public class HomeController : Controller{

public IActionResult Index(){

return View();}

}

Page 41: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Attributerouting

• Attributeroutingenabledbydefault

public class HomeController : Controller{

// ~/ or ~/hello-world[Route("/")][Route("/hello-world")]public IActionResult Index(){

return View();}

}

Page 42: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Attributerouting

• Attributeroutingcanbeappliedtoclass• [controller]and[action]actastokens

[Route("[controller]/[action]")]public class HomeController : Controller{

// ~/Home/Indexpublic IActionResult Index(){

return View();}

}

Page 43: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

CombiningRouteattributes

• Routeattributesinheritpath• RoutePrefix fromMVC5removed

• Canreplaceinheritedpath• Iftemplatestartswith"/"or"~/"

[Route("[controller]")]public class HomeController : Controller{

// ~/Home/hello[Route("hello")]public IActionResult Index(){

return View();}

// ~/hello[Route("/hello")]public IActionResult Index2(){

return View();}

}

Page 44: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Routeparameters

• [Route]allowsparameters• With{param}syntax

• Supportsfilters• With{param:filter}syntax

[Route("[controller]/[action]")]public class HomeController : Controller{

// GET ~/Home/Indexpublic IActionResult Index(){

return View();}

// GET ~/Home/Index/5[Route("{id:int}")]public IActionResult Index(int id){

return View();}

}

Page 45: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

HTTPmethodbasedroutes

• HttpGet,HttpPost,HttpPut,HttpDelete,HttpPatch• Filteractionmethodonrequestmethod• Buildon[Route]semantics

[Route("[controller]/[action]")]public class HomeController : Controller{

// GET ~/Home/Index[HttpGet]public IActionResult Index(){

return View();}

// ~/Submit[HttpPost("/Submit")]public IActionResult Submit(){

return View();}

}

Page 46: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Areas

• Areasdefinedwiththe[Area]attribute• Usedtomatchan{area}routeparam• Attributeroutingallows[area]routetoken

• Viewsmuststillresideunder~/Areas/<area>/Views/<controller>

public void Configure(IApplicationBuilder app){

app.UseMvc(routes =>{

routes.MapRoute("new_default","{area}/{controller=Home}/{action=Index}/{id?}");

});}

[Area("account")]public class HomeController : Controller{

// ...}

Page 47: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

POCOcontrollers

• ControllerclassescanbePOCO• DiscoveredinprojectsthatreferenceMicrosoft.AspNetCore.Mvc.*• Identifiedby"Controller"classnamesuffix• [NonController]disables

Page 48: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Dependencyinjection

• Caninjectdependenciesintocontrollerctor• Specialper-requesttypescanbepropertyinjectedwithdecoratorattribute• ActionContext• ControllerContext

public class HomeController{

IHttpContextAccessor _accessor;

public HomeController(IHttpContextAccessor accessor){

_accessor = accessor;}

[ControllerContext]public ControllerContext ControllerContext { get; set; }

// ...}

Page 49: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Razor

• Sharedconfig• _ViewStart and_ViewImports

• Chunks• @directives

• TagHelpers• LikeWebForms customcontrols

• ViewComponents• Childactionreplacements

Page 50: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Sharedrazorconfiguration

• _ViewStart.cshtml stillexists• Cannoweasilybeputinapplicationroot• Layoutassignmentnolongerisfullpath

• _ViewImports.cshtml isnew• Allowsforsharing@using,@addTagHelperchunksacrossviews• Canbelocatedinthesameplacesas_ViewStart.cshtml

Page 51: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Razordirectives(akachunks)

• @model,@using,@section,@functionsstillexist• @helperisgone• @inject,@addTagHelper arenew

• Also,@awaitHtml.PartialAsync() isnew

Page 52: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

@inject

• Allowsdependencyinjectionintoview• @inject<type><property>

@using Microsoft.Framework.OptionsModel@inject IOptions<MyConfig> Config

<h2>@Config.Options.SiteName</h2>

Page 53: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Taghelpers

• LikecustomcontrolsforMVC• Allowserver-sidecodetoinspecttheelement• Canmodifyattributes,tag,and/orcontents

• @addTagHelper Namespace.ClassName,Assembly• Or@addTagHelper *,Assembly

@addTagHelper SpanTagHelper, YourProjectName

<span emoji="smile" />

Page 54: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Taghelperimplementation

• TagHelper baseclass• Classnameusedtomatchelement

• OverrideProcessorProcessAsync• InspectelementviaTagHelperContext• AlteroutputviaTagHelperOutput

public class SpanTagHelper : TagHelper{

public override void Process(TagHelperContext context, TagHelperOutput output)

{if (context.AllAttributes.ContainsKey("emoji") &&

"smile" == context.AllAttributes["emoji"].ToString()){

output.Attributes.Add("title", "smile");output.Content.SetContent(" :) ");output.SelfClosing = false;

}}

}

Page 55: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Taghelperimplementation

• [TargetElement]canbeusedtomatchelement• Attributescanbeusedtofilter

• [HtmlAttributeName]willreadincomingattribute• Willremovefromoutput

[TargetElement("span", Attributes = "emoji")]public class EmojiTagHelper : TagHelper{

[HtmlAttributeName("emoji")]public string Emoji { get; set; }

public override void Process(TagHelperContext context, TagHelperOutput output)

{if ("smile" == Emoji){

output.Attributes.Add("title", "smile");output.Content.SetContent(" :) ");output.SelfClosing = false;

}}

}

Page 56: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

MVCtaghelpers<a asp-controller="Manage" asp-action="Index">Manage Your Account</a>

<form asp-controller="Account" asp-action="LogOff" method="post"></form>

<environment names="Staging,Production"><h1>You're in production!</h1>

</environment>

<link rel="stylesheet"href="//ajax.aspnetcdn.com/ajax/bootstrap/3.0.0/css/bootstrap.min.css"asp-fallback-href="~/lib/bootstrap/css/bootstrap.min.css"asp-fallback-test-class="hidden" asp-fallback-test-property="visibility" asp-fallback-test-value="hidden" />

<script src="//ajax.aspnetcdn.com/ajax/jquery.validation/1.11.1/jquery.validate.min.js"asp-fallback-src="~/lib/jquery-validation/jquery.validate.js"asp-fallback-test="window.jquery && window.jquery.validator">

</script>

Page 57: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Validationtaghelpers

<form asp-controller="Account" asp-action="ForgotPassword" method="post><h4>Enter your email.</h4>

<div asp-validation-summary="ValidationSummary.All" class="text-danger"></div>

<div><label asp-for="Email"></label><input asp-for="Email" class="form-control" /><span asp-validation-for="Email" class="text-danger"></span>

</div></form>

Page 58: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Viewcomponents

• Replacementforchildactions• Partialviewsstillexist

• Allowforapartialviewthatrunscontroller-likecode• Supportsdependencyinjection

@Component.Invoke("Menu", 3)

Or

@await Component.InvokeAsync("Menu", 3)

Page 59: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Viewcomponents

• ViewComponent baseclass• Matchedbyclassprefix• Orcanuse[ViewComponent]onPOCO

• ImplementInvokeorInvokeAsync• ReturnsIViewComponentResultorTask<IViewComponentResult>

public class MenuViewComponent : ViewComponent{

ICustomMenuService _menu;

public MenuViewComponent(ICustomMenuService menu){

_menu = menu;}

public IViewComponentResult Invoke(int depth){

var menuModel = _menu.GetMenu(depth);return View("Index", menuModel);

}}

Page 60: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Viewcomponents

• Viewcomponentviewsareunder:• ~/Views/<controller>/Components/<component>• ~/Views/Shared/Components/<component>

Page 61: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Filters

• Dependencyinjection• Resourcefilter• Async support

Page 62: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

TypeFilter

• Allowsforfiltersthatrequiredependencyinjection• ImplementedviaIFilterFactory

public class MyActionFilter : Attribute, IActionFilter{

private IHostingEnvironment _env;

public MyActionFilter(IHostingEnvironment env){

_env = env;}

// ...}

[TypeFilter(typeof(MyFilter))]public IActionResult Index(){

// ...}

Page 63: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

IResourceFilter

• Surroundsmodelbinding,action,andresult(includingthosefilters)

• ResourceExecutingContext• Valueproviders,modelbinders,inputformatters,validationproviders• Canaltertheseoneachrequest

public interface IResourceFilter : IFilter{

void OnResourceExecuting(ResourceExecutingContext context);void OnResourceExecuted(ResourceExecutedContext context);

}

Page 64: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Async filters

• AllfiltersnowhaveIAsync<Filter> support• Authorization,Resource,Action,Result,Exception• Patternsimilartomiddlewarepipeline

public class MyResourceFilter : Attribute, IAsyncResourceFilter{

public async Task OnResourceExecutionAsync(ResourceExecutingContext context, ResourceExecutionDelegate next)

{// prevar resourceExecutedContext = await next();// post

}}

Page 65: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

WebAPI

• Formatters• Contentnegotiation• Formatfilters• XMLsupport

Page 66: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Formatters

• Formattershavebeensplitintotwogroups• Inputformatterstriggeredvia[FromBody]• OutputformatterstriggeredviaObjectResult

Page 67: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Inputformatters

• InputFormatter baseclassprovidesstartingpoint• SupportedMediaTypespropertyusedtomatchContent-Typeheader• [Consumes]filtercanbeusedtolimitformatters

Formatter Contenttype Comment

StringInputFormatter text/plain

JsonInputFormatter application/json, text/json

XmlSerializerInputFormatter application/xml, text/xml Notregisteredbydefault

XmlDataContractSerializerInputFormatter application/xml, text/xml Notregisteredbydefault

Page 68: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Outputformatters

• ObjectResult choosesformatterfromAcceptheader• OutputFormatter baseclasshasSupportedMediaTypesproperty• ContentTypespropertyor[Produces]filtercanbesetexplicitlytolimitformatters• IfAcceptcontains"*/*"thenrestofAcceptvaluesignored

• RespectBrowserAcceptHeader onMvcOptions canchangebehavior

Formatter Accepttype Comment

StringOutputFormatter text/plain

JsonOutputFormatter application/json, text/json

XmlSerializerOutputFormatter application/xml, text/xml Notregisteredbydefault

XmlDataContractSerializerOutputFormatter application/xml, text/xml Notregisteredbydefault

Page 69: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

FormatFilter &FormatFilterAttribute

• AllowsoverridingofAcceptheader• Looksfor"format"routeorqueryparam• FormatterMappings onMvcOptions indicatesformattomediatypemapping

• SetsContentTypesonObjectResultpublic void Configure(IApplicationBuilder app){

app.UseMvc(routes =>{

routes.MapRoute("default","api/{controller} ");

routes.MapRoute("formatted","api/{controller}.{format}");

});}

Page 70: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

[Produces]&[Consumes]attributes

• Usedtocontrolwhatformattersusedonrequest/response

[HttpGet][Consumes("application/xml")] [Produces("application/json"")] public object Get(){

return new {...};}

Page 71: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

XMLcompatibilityshim

• LibrarytohelpmigratefromWebAPItoCoreMVC• Microsoft.AspNetCore.Mvc.WebApiCompatShim

• Providesoldclassesthatmaptothenewframework• ApiController• FromUriAttribute• HttpRequestMessage helpers/extensions/modelbinder• HttpResponseMessage helpers/extensions/formatter• HttpResponseException• HttpError

Page 72: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Errorhandling

• HandleError fromMVC5hasbeenremoved• Resourcefilter'spostprocessingrunsafterexceptionfilters• Lastchanceplaceto"handle"exceptionswitharesult• Orjustcanlogexceptions

Page 73: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Errorpages

• Diagnosticsmiddleware• Microsoft.AspNetCore.Diagnostics• UseDeveloperExceptionPage usefulfordevelopment/debuggingerrorinfo• UseExceptionHandler usefulforproductionerrorpages

• Logserrorinformation• Invokeserrorpath

Page 74: .NET Core, ASP.NET Core, and ASP.NET Core MVC · dotnet build / dotnet run / dotnet app.dll ... ASP.NET Core • ASP.NET Core is HTTP pipeline implementation ... • ASP.NET Core

Summary

• Bravenew(yetsomewhatfamiliar)world• .NETCoreisacross-platformframework• ASP.NETCoreis aflexibleHTTPpipeline architecture• MVCandWebAPIhavehadaquiteamakeover


ASP.NET Core 1.0: Understanding ASP.NET Core 1.0 (ASP.NET 5)

ASP.NET Core 1.0: Understanding ASP.NET Core 1.0 (ASP.NET 5)

ASP.NET Core 1.0 Security · ASP.NET Core 1.0 ASP.NET Core 1.0 MVC What's new in Security? Brock Allen brockallen@gmail.com @BrockLAllen

ASP.NET Core 1.0 Security · ASP.NET Core 1.0 ASP.NET Core 1.0 MVC What's new in Security? Brock Allen [email protected] @BrockLAllen

Asp.NET Core Vaidation Controls

Asp.NET Core Vaidation Controls

.NET Core, ASP.NET Core, and ASP.NET Core MVCsddconf.com/brands/sdd/library/aspnetcoremvc.pdf · ASP.NET Core • ASP.NET Core is HTTP pipeline implementation • sits on top of .NET

.NET Core, ASP.NET Core, and ASP.NET Core MVCsddconf.com/brands/sdd/library/aspnetcoremvc.pdf · ASP.NET Core • ASP.NET Core is HTTP pipeline implementation • sits on top of .NET

ASP.NET Core essentials

ASP.NET Core essentials

Chapter 46: .NET Core with csproj · With ASP.NET MVC Core applications, the list of options is slightly longer: > dotnet new mvc --help For ASP.NET MVC Core applications, you can

Chapter 46: .NET Core with csproj · With ASP.NET MVC Core applications, the list of options is slightly longer: > dotnet new mvc --help For ASP.NET MVC Core applications, you can

Build an ASP.NET Core and EF Core Hands On Lab · RUNNING ASP.NET CORE APPLICATIONS Visual Studio Select IIS or Kestrel Port is controlled by launchSetting.json .NET Core CLI ‘dotnet

Build an ASP.NET Core and EF Core Hands On Lab · RUNNING ASP.NET CORE APPLICATIONS Visual Studio Select IIS or Kestrel Port is controlled by launchSetting.json .NET Core CLI ‘dotnet

Introduction to ASP.NET Core

Introduction to ASP.NET Core

ASP.NET Core 1.0

ASP.NET Core 1.0

Asp.NET Core Server Controls

Asp.NET Core Server Controls

Découverte .Net Core et Asp.Net Core

Découverte .Net Core et Asp.Net Core

Middleware in Asp.Net Core

Middleware in Asp.Net Core

ASP.NET Core

ASP.NET Core

Essential Docker for ASP.NET Core MVC · 2017-10-21 · Essential Docker for ASP.NET Core MVC Adam Freeman London, UK ISBN-13 (pbk): 978-1-4842-2777-0 ISBN-13 ... Adding the DotNet

Essential Docker for ASP.NET Core MVC · 2017-10-21 · Essential Docker for ASP.NET Core MVC Adam Freeman London, UK ISBN-13 (pbk): 978-1-4842-2777-0 ISBN-13 ... Adding the DotNet

ASP.NET Core and Docker

ASP.NET Core and Docker

Dotnet- An overview of ASP.NET & ADO.NET- Mazenet solution

Dotnet- An overview of ASP.NET & ADO.NET- Mazenet solution

Dot net platform and dotnet core fundamentals

Dot net platform and dotnet core fundamentals

ASP.NET Core deployment options

ASP.NET Core deployment options

asp.net-core - riptutorial.com · 1 1: asp.net-core 2 2 2 Examples 2 2 Visual Studio 2 ASP.NET MVC . 2 4 ASP.NET Core MVC ASP.NET Core Web API 5 5 6 Visual Studio (cross plateform)

asp.net-core - riptutorial.com · 1 1: asp.net-core 2 2 2 Examples 2 2 Visual Studio 2 ASP.NET MVC . 2 4 ASP.NET Core MVC ASP.NET Core Web API 5 5 6 Visual Studio (cross plateform)

.Net Core - not your daddy's dotnet

.Net Core - not your daddy's dotnet