Dieser Artikel stammt aus dem Jahr 2016. Versionen, Werkzeuge und Empfehlungen können sich seitdem geändert haben. Neuere Beiträge findest du unter ASP.NET Core.
Seit Ende Juni steht ASP.NET Core 1 als RTM zur Verfügung - und es erfreut sich großer Beliebtheit!
In diesem mehrteiligen Beitrag möchte ich einen Einstieg für Interessierte bieten.
Die Plattformunabhängigkeit
Anders als seine Vorgänger ist ASP.NET Core nicht nur auf Windows Zuhause, sondern auch auf Linux und dem macOS. Auch Docker, das - zurecht - derzeit besonders hohe Belebtheit erfährt, wird voll unterstützt.
Eigener Webserver Kestrel
ASP.NET wurde von Haus aus auf dem IIS betrieben. ASP.NET Core hat seinen eigenen Webserver: Kestrel. Kestrel wird hierbei durch ein NuGet Paket mitgeliefert und wirkt als ein Reverse Proxy. Anfragen gehen also zuerst auf einen nativen Webserver wie nginx, IIS oder Apache, anschließend zu Kestrel und werden dann von ASP.NET Core verarbeitet.
1{
2 "buildOptions": {
3 "emitEntryPoint": true
4 },
5 "dependencies": {
6 "Microsoft.NETCore.App": {
7 "type": "platform",
8 "version": "1.0.0"
9 },
10 "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
11 },
12 "frameworks": {
13 "netcoreapp1.0": {}
14 }
15}Das hört sich erstmal kompliziert an; führt aber dazu, dass die gesamte Anwendung um ein vielfaches Performanter läuft und ASP.NET Core nur Kestrel selbst kennen muss.
Console Application
ASP.NET Core ist nur noch eine Konsolenanwendung.
1using System;
2using Microsoft.AspNetCore.Hosting;
3
4namespace ASPNETCore
5{
6 public class Program
7 {
8 public static void Main(string[] args)
9 {
10 var host = new WebHostBuilder()
11 .UseKestrel()
12 .UseStartup<Startup>()
13 .Build();
14
15 host.Run();
16 }
17 }
18}Diese wenigen Zeilen bilden bereits eine vollständig lauffähige ASP.NET Core Webanwendung.
Der WebHostBuilder erstellt dabei den Host der Webanwendung. Neben der Registrierung von Kestrel wird hierbei eine Startup-Klasse referenziert.
1public class Startup
2{
3 public void ConfigureServices(IServiceCollection services)
4 {
5 }
6
7 public void Configure(IApplicationBuilder app)
8 {
9 }
10}Die Startup-Klasse ist dazu da, dass initiale Dinge wie Services oder Applikationseinstellungen global registriert bzw. hinterlegt werden können. Configure ist hierbei dazu da, dass verschiedene und beliebig viele Middleware-Implementierungen angegeben werden können.
Dependency Injection
ASP.NET Core hat seine eigene Dependency Injection-Implementierung. Sie ähnelt stark Unity; wobei auch andere Inversion of Control Container wie NInject verwendet werden können.
Services
Die eingebaute Dependency Injection wird als Basis genommen, um Services in ASP.NET Core zu registrieren. Services sind hierbei zB. DbContext-Implementierungen wie vom SQL Server zB. auf Basis des Entity Framwork Core 1 oder auch Identity Provider für die Authentifizierung.
1public void ConfigureServices(IServiceCollection services)
2{
3 services.AddDbContext<ApplicationDbContext>(options => options.UseSqlServer(Configuration.GetConnectionString("MyConnectionString")));Middleware
Middlewares werden über Startup.Configure der ASP.NET Core 1 Pipeline hinzugefügt. Jeder Request, der ASP.NET Core 1 erreicht, wird durch diese Pipeline geschickt und damit von den registrierten Middleware-Implementierungen verarbeitet.
Zum Beispiel ist die Verarbeitung von URLs im Sinne von Routen eine Middleware.
1public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory lf)
2{
3 app.UseMvc(routes =>
4 {
5 routes.MapRoute(
6 name: "default",
7 template: "{controller=Home}/{action=Index}/{id?}");
8 });
9}Hello world
Ein vollständig, simples Beispiel zu Hello World mit ASP.NET Core 1 seht ihr hier:
1using System;
2using System.Collections.Generic;
3using System.Linq;
4using System.Threading.Tasks;
5using Microsoft.AspNetCore.Builder;
6using Microsoft.AspNetCore.Hosting;
7using Microsoft.AspNetCore.Http;
8using Microsoft.Extensions.DependencyInjection;
9using Microsoft.Extensions.Logging;
10
11namespace AspNetCore_Basics_HelloWorld
12{
13 public class Program
14 {
15 public static void Main(string[] args)
16 {
17 var host = new WebHostBuilder()
18 .UseKestrel()
19 .UseStartup<Startup>()
20 .Build();
21
22 host.Run();
23 }
24 }
25
26 public class Startup
27 {
28 public void ConfigureServices(IServiceCollection services)
29 {
30 }
31 public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory lf)
32 {
33 loggerFactory.AddConsole();
34
35 if (env.IsDevelopment())
36 {
37 app.UseDeveloperExceptionPage();
38 }
39
40 app.Run(async (context) =>
41 {
42 await context.Response.WriteAsync("Hello World!");
43 });
44 }
45 }
46}Related articles
- 1 min read
Better exception details with ASP.NET Core
By default, ASP.NET Core suppresses Exceptions on Startup on external environments. So you only get Exceptions in Startup on localhost.
- 2 min read
ASP.NET Core - Teil 2: die Middleware
Bereit bei ASP.NET 4 konnte man mit Hilfe von OWIN - Open Web Interface for .NET - Middleware-Implementierungen sehr einfach und robust …
- 1 min read
ASP.NET Core - hello world
Hello world Hier ein vollständiges und minimales Beispiel, wie eine simple Hello World Anwendung in ASP.NET Core 1 aussehen kann:
BEN ABT
Ben is Chief Engineering Officer and Principal Software Engineer at Medialesson.de, with a strong focus on .NET and Microsoft Azure. In his professional role, he designs and builds highly scalable platforms for hybrid and cloud-based scenarios. He also advises companies and C-levels on migrating to the sovereign cloud.
He runs myCSharp.de, the largest and most active German-speaking C# community forum, actively contributes to both his own and external open-source projects and regularly shares his knowledge through his blog, at community events, conferences and as a writer for technical magazines.
Let's Work Together
Looking for an experienced Platform Architect or Engineer for your next project? Whether it's cloud migration, platform modernization or building new solutions from scratch - I'm here to help you succeed.