Here’s a summary of what’s new in this preview release:
We cover:
I’ve been building some ASP.NET Core apps as of late and had to dig into how Dependency Injection works there. After talking with Julie Lerman a bit on Twitter about it, I realized that there might be some confusing things about how it works in ASP.NET Core, so I’m hoping I can add some clarity in this post.
{
"name": "asp.net",
"private": true,
"dependencies": {
"bootstrap": "3.3.6",
"jquery": "2.2.0",
"jquery-validation": "1.14.0",
"jquery-validation-unobtrusive": "3.2.6",
"jquery-ajax-unobtrusive": "3.2.4"
}
} [
{
"outputFileName": "wwwroot/css/site.min.css",
"inputFiles": [
"bower_components/bootstrap/dist/css/bootstrap.min.css",
"content/site.css"
]
},
{
"outputFileName": "wwwroot/js/site.min.js",
"inputFiles": [
"bower_components/jquery/dist/jquery.min.js",
"bower_components/jquery-validation/dist/jquery.validate.min.js",
"bower_components/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js",
"bower_components/jquery-ajax-unobtrusive/jquery.unobtrusive-ajax.min.js",
"bower_components/bootstrap/dist/js/bootstrap.min.js"
],
"minify": {
"enabled": true,
"renameLocals": true
},
"sourceMap": false
}
] <!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>@ViewBag.Title - My ASP.NET Application</title>
<link href="~/css/site.min.css" rel="stylesheet" />
</head>
<body>
<div>
<div>
@RenderBody()
</div>
</div>
<script src="~/js/site.min.js" type="text/javascript" asp-append-version="true"></script>
@RenderSection("Scripts", required: false)
</body>
</html> | HTML attribute | AjaxOptions |
| data-ajax-confirm | Confirm |
| data-ajax-method | HttpMethod |
| data-ajax-mode | InsertionMode |
| data-ajax-loading-duration | LoadingElementDuration |
| data-ajax-loading | LoadingElementId |
| data-ajax-begin | OnBegin |
| data-ajax-complete | OnComplete |
| data-ajax-failure | OnFailure |
| data-ajax-success | OnSuccess |
| data-ajax-update | UpdateTargetId |
| data-ajax-url | Url |
| parameters | Callback |
| xhr, status | data-ajax-complete |
| data, status, xhr | data-ajax-success |
| xhr, status, error | data-ajax-failure |
data-ajax-success = "myJsMethod"
function myJsMethod(data, status, xhr) {
} return Json(new { param1 = 1, param2 = 2, ... }); using System.ComponentModel.DataAnnotations;
namespace Core1RtmEmptyTest.ViewModels.Account
{
public class RegisterViewModel
{
[Required]
[EmailAddress]
[Display(Name = "Email")]
public string Email { get; set; }
}
} @using Core1RtmEmptyTest.ViewModels.Account
@model RegisterViewModel
@{
}
<form method="post"
asp-controller="TestAjax"
asp-action="Index"
asp-route-returnurl="@ViewBag.ReturnUrl"
class="form-horizontal"
role="form"
data-ajax="true"
data-ajax-loading="#Progress"
data-ajax-success="myJsMethod">
<input asp-for="Email" class="form-control" />
<span asp-validation-for="Email" class="text-danger"></span>
<button type="submit">ارسال</button>
<div id="Progress" style="display: none">
<img src="images/loading.gif" alt="loading..." />
</div>
</form>
@section scripts{
<script type="text/javascript">
function myJsMethod(data, status, xhr) {
alert(data.param1);
}
</script>
} using Core1RtmEmptyTest.ViewModels.Account;
using Microsoft.AspNetCore.Mvc;
namespace Core1RtmEmptyTest.Controllers
{
public class TestAjaxController : Controller
{
public IActionResult Index()
{
return View();
}
[HttpPost]
public IActionResult Index([FromForm]RegisterViewModel vm)
{
var ajax = isAjax();
if (ajax)
{
// it's an ajax post
}
if (ModelState.IsValid)
{
//todo: save data
return Json(new { param1 = 1, param2 = 2 });
}
return View();
}
private bool isAjax()
{
return Request?.Headers != null && Request.Headers["X-Requested-With"] == "XMLHttpRequest";
}
}
} <div id="EmployeeInfo">
<a
asp-controller="MyController" asp-action="MyAction"
data-ajax="true"
data-ajax-loading="#Progress"
data-ajax-method="POST"
data-ajax-mode="replace"
data-ajax-update="#EmployeeInfo">
Get Employee-1 info
</a>
<div id="Progress" style="display: none">
<img src="images/loading.gif" alt="loading..." />
</div>
</div> public IActionResult Index([FromBody] MyViewModel vm)
{
return View();
} dotnet --info
C:\Users\Vahid>dotnet --info .NET Core SDK (reflecting any global.json): Version: 2.1.301 Commit: 59524873d6 Runtime Environment: OS Name: Windows OS Version: 10.0.17134 OS Platform: Windows RID: win10-x64 Base Path: C:\Program Files\dotnet\sdk\2.1.301\ Host (useful for support): Version: 2.1.1 Commit: 6985b9f684 .NET Core SDKs installed: 2.1.300 [C:\Program Files\dotnet\sdk] 2.1.301 [C:\Program Files\dotnet\sdk] .NET Core runtimes installed: Microsoft.NETCore.App 2.1.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] Microsoft.NETCore.App 2.1.1 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] To install additional .NET Core runtimes or SDKs: https://aka.ms/dotnet-download
<TargetFramework>netcoreapp2.1</TargetFramework>
{
"sdk": {
"version": "2.1.300-rc.31211"
}
} • .NET Core Runtime • .NET Core SDK • .NET Core Hosting Bundle • Visual Studio • ASP.NET Core Installer
• .NET Core SDK • .NET Core Runtime • ASP.NET Core Runtime
- The ASP.NET Runtime Meta Packages - Microsoft.AspNetCore.App - Microsoft.AspNetCore.All
- 32 bit and 64 .NET Core Runtimes - ASP.NET Runtime Packages (Microsoft.AspNetCode.App/All) - IIS Hosting Components
پروژه DNTFrameworkCore که قصد پشتیبانی از آن را دارم، یک زیرساخت سبک وزن و توسعه پذیر با پشتیبانی از طراحی چند مستاجری، با تمرکز بر کاهش زمان و افزایش کیفیت توسعه سیستم‌های تحت وب مبتنی بر ASP.NET Core، توسعه داده شده است.
اهدافی که این زیرساخت دنبال می‌کند
امکانات این زیرساخت در زمان نگارش مطلب جاری
نحوه استفاده از بسته‌های نیوگت مرتبط
PM> Install-Package DNTFrameworkCore -Version 1.0.0
services.AddDNTFramework()
.AddDataAnnotationValidation()
.AddModelValidation()
.AddValidationOptions(options =>
{
/*options.IgnoredTypes.Add(typeof());*/
})
.AddMemoryCache()
.AddAuditingOptions(options =>
{
// options.Enabled = true;
// options.EnabledForAnonymousUsers = false;
// options.IgnoredTypes.Add(typeof());
// options.Selectors.Add(new NamedTypeSelector("SelectorName", type => type == typeof()));
}).AddTransactionOptions(options =>
{
// options.Timeout=TimeSpan.FromMinutes(3);
//options.IsolationLevel=IsolationLevel.ReadCommitted;
}); متدهای الحاقی بالا برای ثبت سرویس‌ها و تنظیمات مرتبط با مکانیزم‌های اعتبارسنجی خودکار، مدیریت تراکنش‌ها، لاگ آماری، Eventing و سایر امکانات ذکر شده، در IoC Container توکار ASP.NET Core استفاده خواهند شد.
PM> Install-Package DNTFrameworkCore.EntityFramework -Version 1.0.0
services.AddDNTUnitOfWork<ProjectDbContext>();
بسته نیوگت بالا شامل پیاده سازی مبتنی بر EF Core برای واسط‌های تعریف شده در بسته نیوگت DNTFrameworkCore، می‌باشد؛ از جمله آن می‌توان به CrudService پایه اشاره کرد. متد الحاقی AddDNTUnitOfWork برای ثبت و معرفی واسط‌های IUnitOfWork و ITransactionProvider به عنوان مهیا کننده تراکنش به همراه پیاده سازهای آنها و همچنین ثبت یک سری Hook تعریف شده برای ردیابی تغییرات، در سیستم تزریق وابستگی، استفاده خواهد شد.
همچنین با نصب بسته بالا، امکان استفاده از مهیا کننده Logging با امکان ذخیره سازی در بانک اطلاعاتی را خواهید داشت:
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseDefaultServiceProvider((context, options) =>
{
options.ValidateScopes = context.HostingEnvironment.IsDevelopment();
})
.ConfigureLogging((hostingContext, logging) =>
{
logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging"));
logging.AddConsole();
logging.AddDebug();
logging.AddEntityFramework<ProjectDbContext>(options => options.MinLevel = LogLevel.Warning);
})
.UseStartup<Startup>(); متد جنریک الحاقی AddEntityFramework برای ثبت مهیا کننده مذکور استفاده می‌شود.
PM> Install-Package DNTFrameworkCore.Web -Version 1.0.0
بسته نیوگت بالا شامل یکسری سرویس برای اعمال دسترسی‌های پویا، CrudController مبتنی بر ASP.NET Core Web API، فیلتر مدیریت سراسری خطاهای برنامه و سایر امکاناتی که در ادامه مقالات با جزئیات بیشتری بررسی خواهیم کرد، می‌باشد. برای ثبت سرویس‌های تعریف شده می‌توانید از متد الحاقی AddDNTCommonWeb و به منظور تغییر محل ذخیره سازی کلیدهای موقت رمزنگاری مرتبط با Data Protection API و انتقال آنها به بانک اطلاعاتی، استفاده کنید.
services.AddDNTCommonWeb()
.AddDNTDataProtection();
نکته: برای انتقال کلیدهای موقت رمزنگاری به بانک اطلاعاتی، نیاز است تا از متد الحاقی زیر که در بسته نیوگت DNTFrameworkCore.EntityFramework موجود می‌باشد، به شکل زیر استفاده کنید:
services.AddDNTProtectionRepository<ProjectDbContext>();
PM> Install-Package DNTFrameworkCore.EntityFramework.SqlServer -Version 1.0.0
بسته بالا از امکانات مخصوص SqlServer برای اعمال قفل منطقی برای مدیریت مباحث همزمانی استفاده می‌کند؛ همچنین PreUpdateHook مرتبط با تولید خودکار کد منحصر به فرد، در این کتابخانه پیاده سازی شده است. به شکل زیر می‌توانید سرویس‌های مرتبط با آن را به سیستم تزریق وابستگی‌های معرفی کنید:
services.AddDNTNumbering(options =>
{
options.NumberedEntityMap[typeof(Task)] = new NumberedEntityOption
{
Start = 100,
Prefix = "Task-",
IncrementBy = 5
};
}); به عنوان مثال برای شماره گذاری موجودیت Task، لازم است تنظیمات مرتبط آن را به شکل بالا به سیستم شماره گذاری معرفی کنید.
اگر قصد استفاده از کتابخانه FluentValidation را داشته باشید، می‌بایست بسته زیر را نیز نصب کنید:
PM> Install-Package DNTFrameworkCore.FluentValidation -Version 1.0.0
برای ثبت و معرفی Adapter مرتبط، به سیستم اعتبارسنجی خودکار معرفی شده، لازم است از طریق متد الحاقی AddFluentModelValidation به شکل زیر اقدام کنید:
services.AddDNTFramework()
.AddDataAnnotationValidation()
.AddModelValidation()
.AddFluentModelValidation()
.AddValidationOptions(options =>
{
/*options.IgnoredTypes.Add(typeof());*/
})
.AddMemoryCache()
.AddAuditingOptions(options =>
{
// options.Enabled = true;
// options.EnabledForAnonymousUsers = false;
// options.IgnoredTypes.Add(typeof());
// options.Selectors.Add(new NamedTypeSelector("SelectorName", type => type == typeof()));
}).AddTransactionOptions(options =>
{
// options.Timeout=TimeSpan.FromMinutes(3);
//options.IsolationLevel=IsolationLevel.ReadCommitted;
});
برای شروع پروژه جدید، نصب این بسته‌ها کفایت می‌کند. اگر نیاز به طراحی MultiTenancy دارید، بسته زیر را برای شناسایی Tenant جاری و از این قبیل کارها نیز می‌بایست نصب کنید:
PM> Install-Package DNTFrameworkCore.Web.MultiTenancy -Version 1.0.0
services.AddMultiTenancy<TenantResolver>();
app.UseMultiTenancy();
services.Scan(scan => scan
.FromCallingAssembly()
.AddClasses(classes => classes.AssignableTo<ISingletonDependency>())
.AsMatchingInterface()
.WithSingletonLifetime()
.AddClasses(classes => classes.AssignableTo<IScopedDependency>())
.AsMatchingInterface()
.WithScopedLifetime()
.AddClasses(classes => classes.AssignableTo<ITransientDependency>())
.AsMatchingInterface()
.WithTransientLifetime()
.AddClasses(classes => classes.AssignableTo(typeof(IDomainEventHandler<>)))
.AsImplementedInterfaces()
.WithTransientLifetime());
foreach (var descriptor in services.Where(s => typeof(IApplicationService).IsAssignableFrom(s.ServiceType))
.ToList())
{
services.Decorate(descriptor.ServiceType, (target, serviceProvider) =>
ProxyGenerator.CreateInterfaceProxyWithTargetInterface(
descriptor.ServiceType,
target, serviceProvider.GetRequiredService<ValidationInterceptor>(),
(IInterceptor) serviceProvider.GetRequiredService<TransactionInterceptor>()));
} ASP.NET Core 1.0 is the ground-up rewrite of ASP.NET, MVC and Web API, bringing a new paradigm in building web applications and APIs in .NET. With this rewrite brought new techniques in building SOLID applications, and updated some existing patterns and tools.
In this session, we'll take a lap around some of the major extension points of ASP.NET Core 1.0, walking through how these features can help us build cleaner, more maintainable systems. We'll cover web APIs, traditional MVC applications, controllers, views, filters, dependency injection, tag helpers and more. With a SOLID foundation, our ASP.NET Core applications will be dead simple to build and maintain.
.NET 8 Preview 4 is now available and includes many great new improvements to ASP.NET Core.
Here’s a summary of what’s new in this preview release:
Blazor
Streaming rendering with Blazor components
Handling form posts with Blazor SSR
Route to named elements in Blazor
Webcil packaging for Blazor WebAssembly apps
API authoring
Expanded support for form binding in minimal APIs
API project template includes .http file
Native AOT
Logging and exception handling in compile-time generated minimal APIs
ASP.NET Core top-level APIs annotated for trim warnings
Reduced app size with configurable HTTPS support
Worker Service template updates
Additional default services configured in the slim builder
API template JSON configuration changes
Support for JSON serialization of compiler-generated IAsyncEnumerable unspeakable types
Authentication and authorization
Identity API endpoints
Improved support for custom authorization policies with IAuthorizationRequirementData
ASP.NET Core metrics
For more details on the ASP.NET Core work planned for .NET 8 see the full ASP.NET Core roadmap for .NET 8 on GitHub.
Here's the list of what's new in this preview:
