به روز رسانی جهت Blazor 6x  
با توجه به امکان تعریف [Parameter, SupplyParameterFromQuery] در Blazor 6x، دیگر نیازی به استفاده‌ی مستقیم از HttpUtility.ParseQueryString، جهت پردازش مقادیر کوئری استرینگ‌های رسیده، نیست. اطلاعات بیشتر
وحید نصیری وحید نصیری
Blazor 5x - قسمت دهم - مبانی Blazor - بخش 7 - مسیریابی
‫۲ سال و ۹ ماه قبل، شنبه ۱۵ آبان ۱۴۰۰، ساعت ۱۳:۵۰
بهبود قسمت «ارسال کوئری استرینگ‌ها به کامپوننت‌های مختلف » در Blazor 6x

در Blazor 6x دیگر نیازی نیست تا با استفاده از «HttpUtility.ParseQueryString»، کار پردازش دستی کوئری استرینگ‌های رسیده، صورت گیرد. برای نمونه فرض کنید Url رسیده، چنین شکلی را دارد:
/search?filter=some+stuff&page=3&assignee=User1&assignee=User2
برای دسترسی به مقادیر کوئری استرینگ‌های آدرس فوق، اینبار کافی است به صورت زیر عمل کنیم:
@code {
    [Parameter]
    [SupplyParameterFromQuery]
    public string Filter { get; set; }

    [Parameter]
    [SupplyParameterFromQuery]
    public int? Page { get; set; }

    [Parameter]
    [SupplyParameterFromQuery(Name = "assignee")]
    public string[] Assignees { get; set; }
}
یعنی ذکر دو ویژگی [Parameter, SupplyParameterFromQuery] بر روی یک خاصیت عمومی کامپوننت، آن‌را آماده‌ی دریافت مقادیر کوئری استرینگ‌های متناظری می‌کند. اگر می‌خواهید نام پارامتر، با نام کوئری استرینگ یکی نباشد (حالت پیش‌فرض)، از خاصیت Name این ویژگی می‌توان استفاده کرد.

نکته: در اینجا مقادیری مانند ذیل قابل قبول هستند:
String, bool, DateTime, decimal, double, float, Guid, int, long
و یا حالت Nullable آن‌ها و یا آرایه‌ای آن‌ها.

امکان ساخت Urlهایی به همراه کوئری استرینگ‌ها جهت هدایت ساده‌تر به آن‌ها

به Blazor 6x، متدهای الحاقی UriWithQueryParameter نیز اضافه شده‌اند و کار آن‌ها، افزودن ساده‌تر کوئری‌استرینگ‌ها به Urlها است که نمونه‌ای از آن به صورت زیر است: 
var actualUri = NavigationManager.GetUriWithQueryParameters(new Dictionary<string, object>
        {
            ["full name"] = "John Doe", // Single value
            ["ping"] = new int?[] { 35, 16, null, 87, 240 }
        });
که چنین Url ای را تولید می‌کند (نمونه‌ای از روش تعریف کوئری استرینگ‌های آرایه‌ای):
host/?full%20name=John%20Doe&ping=35&ping=16&ping=87&ping=240
مثال‌های بیشتر آن‌را در اینجا می‌توانید مشاهده کنید.
وحید نصیری وحید نصیری
ارتقاء به ASP.NET Core 1.0 - قسمت 13 - معرفی View Components
‫۲ سال و ۱۰ ماه قبل، سه‌شنبه ۱۱ آبان ۱۴۰۰، ساعت ۱۵:۵۵
«....  یک نکته: اگر نام کلاسی به ViewComponent  ختم شده بود، نیازی نیست تا ViewComponent  را هم در حین ساخت پوشه‌ی آن ذکر کرد... »
ViewComponent را هم از نام کلاس و هم از نام پوشه حذف و بر این اساس مسیرها را اصلاح کنید.
وحید نصیری وحید نصیری
امکان تعریف ساده‌تر کلاس‌های Immutable در C# 9.0 با معرفی نوع جدید record
‫۲ سال و ۱۰ ماه قبل، دوشنبه ۱۰ آبان ۱۴۰۰، ساعت ۱۴:۵۵
بهبودهای جزئی کار با رکوردها در C# 10.0

الف) در C# 10.0 می‌توان از واژه‌ی کلیدی اختیاری class هم در کنار واژه‌ی کلیدی record، استفاده کرد. هر دو سطر ذیل در C# 10.0 به یک معنا هستند:
public record class Test(string Name, string Surname);
public record Test(string Name, string Surname);

ب) امکان تعریف structها به صورت رکورد در C# 10.0
علت امکان ذکر واژه‌ی کلیدی class را در اینجا می‌توان دریافت. structها از نوع value type هستند و اکنون در C# 10.0 می‌توان struct‌ها را هم به صورت record تعریف کرد:
record struct Test(string Name, string Surname)
بنابراین ذکر اختیاری واژه‌ی class، صرفا تاکیدی بر reference type بودن record‌ها در حالت پیش‌فرض آن‌ها است.
البته در اینجا یک تفاوت مهم نیز با recordهای کلاسی وجود دارد؛ در حالت رکوردهای از نوع struct، خواص تعریف شده‌ی توسط آن‌ها، به صورت پیش‌فرض mutable هستند:
string Name { get; set; }
string Surname { get; set; }
یعنی بجای set، از init استفاده نشده‌است (برخلاف record‌های کلاسی).
اگر خواستیم خواص آن‌ها نیز immutable شوند، فقط کافی است یک واژه‌ی کلیدی readonly را به تعریف آن‌ها اضافه کنیم:
readonly record struct Test(string Name, string Surname);
به این ترتیب اینبار خواص تعریف شده‌ی توسط رکورد، init دار می‌شوند:
string Name { get; init; }
string Surname { get; init; }

ج) امکان ارث‌بری ToString
همانطور که در مطلب فوق نیز عنوان شده‌است، رکوردها به همراه یک متد ToString از پیش تهیه شده‌ی توسط کامپایلر هستند. در C# 9.0، اشیاء ارث‌بری شده‌ی از رکوردها، قابلیت ارث‌بری نمونه‌ی بازنویسی شده‌ی این متد را ندارند (یعنی هر رکورد، یک ToString خاص خودش را پیدا می‌کند؛ حتی اگر ارث‌بری شده باشد). در C# 10.0 می‌توان متد ToString پایه را به صورت sealed تعریف کرد:
public record TestRec(string name, string surname)
{
    public sealed override string ToString()
    {
        return $"{name} {surname}";
    }
}
این مورد سبب می‌شود تا کامپایلر به اشیاء ارث‌بری شده نیز امکان دسترسی به ToString کلاس پایه را بدهد و به ازای هر نمونه‌ی ارث‌بری شده، یک ToString خاص آن‌را به صورت خودکار تولید نکند.
وحید نصیری وحید نصیری
C# 8.0 - Pattern Matching
‫۲ سال و ۱۰ ماه قبل، یکشنبه ۹ آبان ۱۴۰۰، ساعت ۲۳:۱۵
بهبود «Property Patterns معرفی شده‌ی در C# 8.0» در C# 10.0

در C# 8.0 برای بررسی خواص تو در تو باید از الگوی زیر استفاده کرد:
....{property: {subProperty: pattern}}....
که این الگو در C# 10.0 به صورت زیر ساده شده‌است:
....{property.subProperty: pattern}....

یک مثال:
رکورد زیر را در نظر بگیرید:
public record TestRec(string name, string surname);
روش پیشین دسترسی به خاصیت طول name به صورت زیر است:
string TakeFourSymbols(TestRec obj) => obj switch
{
    TestRec { name: {Length: > 4} } rec => rec.name.Substring(0,4),
    // ...
};
که اکنون در C# 10.0 کمی متداول‌تر و ساده‌تر شده‌است:
string TakeFourSymbols(TestRec obj) => obj switch
{
    TestRec { name.Length: > 4 } rec => rec.name.Substring(0,4),
    // ...
};
وحید نصیری وحید نصیری
ساده سازی تعریف فضاهای نام در C# 10.0
‫۲ سال و ۱۰ ماه قبل، پنجشنبه ۶ آبان ۱۴۰۰، ساعت ۱۰:۴۷
یک نکته‌ی تکمیلی: وادار کردن خود به استفاده‌ی یک‌دست از این قابلیت در سراسر Solution

می‌توان با تنظیم فایل editorconfig. که در کنار فایل sln. قرار دارد، زیر تمام فضاهای نام پیشین، یک خط اخطار جهت ارتقاء به روش جدید کشید. برای اینکار تنها کافی است تنظیم زیر را به آن اضافه کنید: 
[*.cs]

csharp_style_namespace_declarations = file_scoped:warning

و همچنین اگر می‌خواهید پس از این تغییر، تمام فایل‌ها را یکجا به روز رسانی کنید، در NET 6.، برنامه‌ی dotnet-format، جزء استاندارد SDK است. به همین جهت در همان ریشه‌ی sln.، دستور زیر را صادر کنید:
dotnet format
البته اگر فقط می‌خواهید لیست تغییراتی را که صورت می‌گیرند مشاهده کنید، دستور زیر را صادر کنید:
dotnet format --verify-no-changes
وحید نصیری وحید نصیری
کاهش تعداد بار تعریف using ها در C# 10.0 و NET 6.0.
‫۲ سال و ۱۰ ماه قبل، یکشنبه ۲ آبان ۱۴۰۰، ساعت ۱۳:۳۶
یک نکته‌ی تکمیلی: امکان تعریف Alias
در اینجا نیز امکان تعریف یک Alias برای فضای نام خاصی وجود دارد:
global using DT = System.DateTime;
و همچنین تمام این موارد (حالت global معمولی، استاتیک و یا به همراه Alias) را:
global using App.Models;
global using static System.Console;
global using DT = System.DateTime;
می‌توان در فایل csproj. هم تعریف کرد:
<ItemGroup>
    <Using Include="App.Models"/>
    <Using Include="System.Console" Static="True" />
    <Using Include="System.DateTime" Alias="DT" />
</ItemGroup>
وحید نصیری وحید نصیری
C# 7 - Tuple return types and deconstruction
‫۲ سال و ۱۰ ماه قبل، شنبه ۱ آبان ۱۴۰۰، ساعت ۲۱:۱۱
بهبود نحوه‌ی انتساب Tuples در حین deconstruction در C# 10.0
پیشتر از یکی از دو روش زیر برای تعریف و مقدار دهی متغیرهای حاصل از deconstruction می‌شد استفاده کرد؛ یا استفاده از var برای هر دو و یا تعریف و مقدار دهی هر دو خارج از deconstruction: 
Car car = new("Test", "Blue");

var (model, color) = car;
// Initialization

string model = string.Empty;
string color = string.Empty;
(model, color) = car;
// Assignment
در C# 10.0 این محدودیت برطرف شده‌است و هر دو حالت را می‌توان با هم داشت:
string model = string.Empty;
(model, var color) = car;
// Initialization and assignment