‫۴ سال و ۱۱ ماه قبل، چهارشنبه ۱۰ مهر ۱۳۹۸، ساعت ۱۱:۵۹
یک نکته‌ی تکمیلی: چگونه برنامه‌های ASP.NET Core را به صورت دستی ری‌استارت کنیم؟

با توجه به چندسکویی بودن ASP.NET Core، برای نمونه در لینوکس، تغییراتی مانند تغییر در web.config، سبب ری‌استارت برنامه نمی‌شوند. در این حالت برای بارگذاری تغییرات، می‌توان از روش دستی ری‌استارت برنامه استفاده کرد:
[Authorize(Roles = "Admin")] 
public class AdminController : Controller 
{ 
    private readonly IApplicationLifetime _applicationLifetime;
 
    public AdminController(IApplicationLifetime appLifetime) 
    { 
        _applicationLifetime = appLifetime; 
    } 
 
    public IActionResult Shutdown() 
    { 
       _applicationLifetime.StopApplication(); 
       return Content("Done"); 
    } 
}
در اینجا از سرویس توکار IApplicationLifetime و متد StopApplication آن برای recycle/restart برنامه استفاده شده‌است. بدیهی است دسترسی به یک چنین اکشن متدی باید کاملا کنترل شده باشد.
‫۴ سال و ۱۱ ماه قبل، دوشنبه ۸ مهر ۱۳۹۸، ساعت ۲۱:۴۹
اصلاحیه برای SQLite

EF Core یکسری از نوع‌ها را مانند bool و DateTime به صورت رشته‌ای در SQLite ذخیره می‌کند. به همین جهت سطر زیر در PersianYeKeCommandInterceptor فوق، سبب از کار افتادن این نوع‌ها می‌شود؛ چون برای مثال DateTime را هم تبدیل به رشته می‌کند (پیش از موعد و با فرمتی که مدنظر EF Core نیست):
parameter.Value =   parameter.Value is DBNull ? parameter.Value : parameter.Value.ToString().ApplyCorrectYeKe();
روش اصلاح شده‌ی آن به صورت زیر است که رشته‌ای بودن خود Value را هم بررسی می‌کند:
if (!(parameter.Value is DBNull) && parameter.Value is string)
{
   parameter.Value =  Convert.ToString(parameter.Value, CultureInfo.InvariantCulture).ApplyCorrectYeKe();
}
‫۴ سال و ۱۱ ماه قبل، دوشنبه ۸ مهر ۱۳۹۸، ساعت ۱۵:۵۴
یک نکته‌ی تکمیلی:  طراحی یک Interceptor برای یک دست سازی ی و ک در EF Core

یکی از ویژگی‌های جدید EF Core 3.0، بازگشت مجدد Interceptorهایی است که در این مطلب در مورد آن‌ها بحث شده‌است. اگر بخواهیم مطلب جاری را برای EF Core 3.0 بازنویسی کنیم، به کلاس زیر خواهیم رسید:
using System;
using System.Data;
using System.Data.Common;
using System.Threading;
using System.Threading.Tasks;
using DNTPersianUtils.Core; // dotnet add package DNTPersianUtils.Core 
using Microsoft.EntityFrameworkCore.Diagnostics;

namespace EFCore3Interceptors
{
    public class PersianYeKeCommandInterceptor : DbCommandInterceptor
    {
        public override InterceptionResult<DbDataReader> ReaderExecuting(
            DbCommand command,
            CommandEventData eventData,
            InterceptionResult<DbDataReader> result)
        {
            ApplyCorrectYeKe(command);
            return result;
        }

        public override Task<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
            DbCommand command,
            CommandEventData eventData,
            InterceptionResult<DbDataReader> result,
            CancellationToken cancellationToken = new CancellationToken())
        {
            ApplyCorrectYeKe(command);
            return Task.FromResult(result);
        }

        public override InterceptionResult<int> NonQueryExecuting(
            DbCommand command, 
            CommandEventData eventData,
            InterceptionResult<int> result)
        {
            ApplyCorrectYeKe(command);
            return result;
        }

        public override Task<InterceptionResult<int>> NonQueryExecutingAsync(
            DbCommand command, 
            CommandEventData eventData, 
            InterceptionResult<int> result,
            CancellationToken cancellationToken = new CancellationToken())
        {
            ApplyCorrectYeKe(command);
            return Task.FromResult(result);
        }

        public override InterceptionResult<object> ScalarExecuting(
            DbCommand command, 
            CommandEventData eventData, 
            InterceptionResult<object> result)
        {
            ApplyCorrectYeKe(command);
            return result;
        }

        public override Task<InterceptionResult<object>> ScalarExecutingAsync(
            DbCommand command, 
            CommandEventData eventData, 
            InterceptionResult<object> result,
            CancellationToken cancellationToken = new CancellationToken())
        {
            ApplyCorrectYeKe(command);
            return Task.FromResult(result);
        }

        private static void ApplyCorrectYeKe(DbCommand command)
        {
            command.CommandText = command.CommandText.ApplyCorrectYeKe();

            foreach (DbParameter parameter in command.Parameters)
            {
                switch (parameter.DbType)
                {
                    case DbType.AnsiString:
                    case DbType.AnsiStringFixedLength:
                    case DbType.String:
                    case DbType.StringFixedLength:
                    case DbType.Xml:
                        parameter.Value =   parameter.Value is DBNull ? parameter.Value : parameter.Value.ToString().ApplyCorrectYeKe();
                        break;
                }
            }
        }
    }
}

و روش استفاده و معرفی آن به سیستم توسط متد AddInterceptors، به صورت زیر است:
namespace EFCore3Interceptors
{
    public class BloggingContext : DbContext
    {
        // ...
 
        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            if (!optionsBuilder.IsConfigured)
            {
                optionsBuilder
                    .UseSqlServer("...")
                    .AddInterceptors(new PersianYeKeCommandInterceptor());
            }
        }
    }
}
‫۴ سال و ۱۱ ماه قبل، یکشنبه ۷ مهر ۱۳۹۸، ساعت ۱۲:۵۸
یک نکته‌ی تکمیلی: انتخاب Target Framework ترجیح داده شده در VSCode

اگر در حال تهیه‌ی یک کتابخانه‌ی چند Target ای هستید، برای مثال تنظیمات فایل csproj آن چنین شکلی را پیدا می‌کند:
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;netstandard2.1;netstandard1.3;net451;net461;</TargetFrameworks>
اما مشکلی که با VSCode وجود دارد این است که نمی‌توان Target Framework ترجیح داده شده‌ی در حین توسعه را انتخاب کرد. برای مثال VSCode را وادار کرد که صرفا بر اساس netstandard1.3 در این لیست، کار نمایش خطاهای موجود را انجام دهد. روش انتخاب Target Framework غالب در اینجا، ذکر آن «در ابتدای لیست» است. برای نمونه در مثال فوق، VSCode و افزونه‌ی #C آن بر اساس netstandard2.0 محیط توسعه را آماده می‌کند. اگر می‌خواهید بر اساس netstandard1.3 کار کند، آن‌را در ابتدای لیست قرار دهید.

البته Rider در این زمینه امکانات بیشتری را دارد. برای مثال در status bar آن، امکان انتخاب Target Framework ترجیح داده شده از طریق منویی وجود دارد:
 

‫۴ سال و ۱۱ ماه قبل، جمعه ۵ مهر ۱۳۹۸، ساعت ۱۲:۴۵
یک نکته‌ی تکمیلی: امکان استفاده‌ی از nullable attributes فوق در NET Standard 2.0. هم وجود دارد

nullable attributes ای را که در اینجا مشاهده می‌کنید، تنها در برنامه‌های مبتنی بر NET Core 3.0. و یا .NET Standard 2.1. قابل تعریف هستند. اما اگر کلاس‌های همین ویژگی‌ها را به صورت Internal در پروژه‌های قدیمی‌تر نیز به صورت دستی تعریف کنید، توسط کامپایلر جدید C# 8.0، شناسایی شده و استفاده می‌شوند. نمونه‌ی اینکار در پروژه‌ی JSON.NET انجام شده‌است. جهت ساده سازی اینکار، پروژه‌ی « Nullable » این ویژگی‌ها را به صورت یک بسته‌ی نیوگت برای پروژه‌های قدیمی‌تر، تهیه کرده‌است.