‫StringValues: ابزاری فراتر از آرایه‌های رشته‌ای هوشمند

Accept: text/html, application/xhtml+xml, application/xml

// راه‌حل قدیمی
string[] tags = context.Request.Query["tag"].ToArray();

• تخصیص حافظه غیرضروری: حتی اگر فقط یک مقدار وجود داشته باشد، یک آرایه ایجاد می‌شود.
• عدم یکپارچگی نوع: گاهی باید بررسی کنید که آیا مقدار null است، خالی است یا تک‌عنصری.
• پیچیدگی در تبدیل: تبدیل بین string و string[] نیاز به کد اضافی داشت.
• عملکرد ضعیف در سناریوهای پرترافیک: تخصیص‌های مکرر حافظه باعث فشار بر جمع‌آوری زباله (Garbage Collector) می‌شود.

using Microsoft.Extensions.Primitives;

StringValues greeting = "سلام، دنیا!";

// دسترسی مستقیم
Console.WriteLine(greeting);        // خروجی: سلام، دنیا!
Console.WriteLine(greeting[0]);     // خروجی: سلام، دنیا!

نکته: حتی با یک مقدار، نیازی به ایجاد آرایه نیست.

StringValues tags = new StringValues(new[] { "csharp", "dotnet", "performance" });

// دسترسی با اندیس
Console.WriteLine(tags[1]); // خروجی: dotnet

// تکرار با foreach
foreach (var tag in tags)
{
    Console.WriteLine(tag);
}

StringValues fruits = new StringValues(new[] { "سیب", "موز", "گیلاس" });

string[] array = fruits; // تبدیل ضمنی!

foreach (var fruit in array)
{
    Console.WriteLine(fruit);
}

StringValues empty = StringValues.Empty;

if (StringValues.IsNullOrEmpty(empty))
{
    Console.WriteLine("هیچ مقداری وجود ندارد");
}

نکته:StringValues.Empty یک نمونه ایستا و بهینه‌شده است که معادل default(StringValues) است و نیازی به new ندارد.

var cache = new Dictionary<StringValues, string>();

StringValues key = new StringValues(new[] { "user", "123" });
cache[key] = "داده‌های کش‌شده";

Console.WriteLine(cache[key]);

این قابلیت در سناریوهای کلید ترکیبی (مثل ترکیب کاربر + نقش) بسیار مفید است.

[HttpGet]
public IActionResult Search([FromQuery] string[] tag)
{
    StringValues tags = Request.Query["tag"]; // خودکار StringValues است
    return Ok(tags);
}

در اینجا، Request.Query["tag"] از نوع StringValues است؛ حتی اگر فقط یک مقدار ارسال شود.

• از StringValues.Empty به جای new StringValues() استفاده کنید.
• از تبدیل ضمنی به string[] فقط در صورت نیاز استفاده کنید؛ در اکثر موارد، مستقیماً با StringValues کار کنید.
• در حلقه‌های پرترافیک، از Count و اندیس‌گذاری استفاده کنید تا از تخصیص‌های IEnumerator جلوگیری شود.

for (int i = 0; i < values.Count; i++)
{
    Console.WriteLine(values[i]);
}

• یک یا چند مقدار را با یک نوع مدیریت کنید
• بدون تخصیص آرایه در حالت تک‌عنصری
• تبدیل ضمنی به string و string[]
• قابل استفاده به عنوان کلید دیکشنری
• بهینه‌شده برای ASP.NET Core