‫آشنایی با محدودیت‌های استفاده از ValueTask در برنامه‌نویسی .NET

public void CreateListenKey()
{
    var result = CreateSpotListenKeyAsync().GetAwaiter().GetResult(); // هشدار CA2012
}

public async Task CreateListenKeyAsync()
{
    var result = await CreateSpotListenKeyAsync();
    // ادامه پردازش نتیجه
}

public void CreateListenKey()
{
    var valueTask = CreateSpotListenKeyAsync();
    if (valueTask.IsCompleted)
    {
        var result = valueTask.GetAwaiter().GetResult();
        // استفاده از نتیجه
    }
    else
    {
        // تبدیل به Task و انتظار
        var result = valueTask.AsTask().GetAwaiter().GetResult();
    }
}

public void CreateListenKey()
{
    var result = CreateSpotListenKeyAsync().Preserve().GetAwaiter().GetResult();
    // استفاده از نتیجه
}

• مصرف یک‌بار:ValueTask تنها باید یک‌بار منتظر شود یا نتیجه‌اش خوانده شود. استفاده مجدد از آن ممکن است به خطا یا رفتار نامشخص منجر شود.
• عدم پشتیبانی از بلوکه کردن مستقیم: برخلاف Task، استفاده از Result یا GetAwaiter().GetResult() بدون اطمینان از تکمیل، ایمن نیست.
• پیچیدگی بیشتر: استفاده از ValueTask نسبت به Task پیچیدگی بیشتری به کد اضافه می‌کند و باید با دقت مدیریت شود.

• عملیات اغلب به‌صورت همگام تکمیل می‌شود (مثلاً دسترسی به حافظه نهان).
• کاهش تخصیص حافظه برای بهبود عملکرد حیاتی است.
• مصرف‌کنندگان API شما معمولاً از await مستقیم استفاده می‌کنند.

public async ValueTask<int> GetValueAsync(bool isAsync)
{
    if (!isAsync)
        return 42; // تکمیل همگام
    await Task.Delay(1000);
    return 42; // تکمیل ناهمگام
}

public async Task UseValueAsync()
{
    int result = await GetValueAsync(false);
    Console.WriteLine(result); // خروجی: 42
}

public void UseValueSync()
{
    var valueTask = GetValueAsync(false);
    int result = valueTask.IsCompleted ? valueTask.GetAwaiter().GetResult() : valueTask.AsTask().Result;
    Console.WriteLine(result); // خروجی: 42
}

• نمونه‌های ValueTask نباید مستقیماً به نتیجه خود دسترسی داشته باشند مگر اینکه تکمیل شده باشند
• محدودیت‌های ValueTask
• CA2012: استفاده صحیح از ValueTask