‫درک Task.Delay در برنامه‌نویسی ناهمگام #C

// مسدودکننده - در کد ناهمگام از این استفاده نکنید!
Thread.Sleep(1000); // رشته را برای 1 ثانیه مسدود می کند

// غیرمسدودکننده - روش صحیح در کد ناهمگام
await Task.Delay(1000); // بدون مسدود کردن، 1 ثانیه صبر می کند

public async Task<IEnumerable<Data>> FetchDataWithRateLimitAsync()
{
    var results = new List<Data>();

    foreach (var item in items)
    {
        // Fetch data
        var data = await apiClient.GetDataAsync(item);
        results.Add(data);

        // Wait 1 second before next request
        await Task.Delay(1000);
    }

    return results;
}

public async Task<T> RetryWithBackoffAsync<T>(Func<Task<T>> operation, int maxRetries = 3)
{
    for (int i = 0; i < maxRetries; i++)
    {
        try
        {
            return await operation();
        }
        catch (Exception) when (i < maxRetries - 1)
        {
            // Exponential backoff: 1s, 2s, 4s, ...
            await Task.Delay(TimeSpan.FromSeconds(Math.Pow(2, i)));
        }
    }

    // Last attempt
    return await operation();
}

public async Task UpdateProgressBarAsync()
{
    for (int i = 0; i <= 100; i++)
    {
        progressBar.Value = i;
        // Give UI thread time to update
        await Task.Delay(50);
    }
}

public async Task<bool> WaitForConditionAsync(Func<bool> condition, TimeSpan timeout)
{
    var startTime = DateTime.UtcNow;

    while (!condition())
    {
        if (DateTime.UtcNow - startTime > timeout)
            return false;

        await Task.Delay(100);
    }

    return true;
}

// ❌ بد: رشته را مسدود می کند
public async Task BadMethodAsync()
{
    Thread.Sleep(1000); // رشته را مسدود می کند
    await DoSomethingAsync();
}

// ✅ خوب: تأخیر غیرمسدودکننده
public async Task GoodMethodAsync()
{
    await Task.Delay(1000); // مسدود نمی کند
    await DoSomethingAsync();
}

// ❌ بد: فراموش کرده اید await کنید
public async Task BadMethodAsync()
{
    Task.Delay(1000); // Task را ایجاد می کند اما منتظر آن نمی ماند
    Console.WriteLine("This prints immediately!");
}

// ✅ خوب: به درستی await شده است
public async Task GoodMethodAsync()
{
    await Task.Delay(1000);
    Console.WriteLine("This prints after 1 second!");
}

public async Task<bool> TryOperationWithTimeoutAsync(
    Func<Task> operation, 
    TimeSpan timeout)
{
    using var cts = new CancellationTokenSource(timeout);
    
    try
    {
        await Task.WhenAny(
            operation(),
            Task.Delay(timeout, cts.Token)
        );
        return true;
    }
    catch (OperationCanceledException)
    {
        return false;
    }
}

public static class DelayExtensions
{
    public static async Task DelayWithProgressAsync(
        TimeSpan duration,
        IProgress<double> progress = null)
    {
        var startTime = DateTime.UtcNow;
        var endTime = startTime + duration;
        
        while (DateTime.UtcNow < endTime)
        {
            var elapsed = DateTime.UtcNow - startTime;
            var percentage = elapsed.TotalMilliseconds / duration.TotalMilliseconds;
            progress?.Report(percentage);
            
            await Task.Delay(100);
        }
        
        progress?.Report(1.0);
    }
}

• ایجاد شیء Task: هر فراخوانی Task.Delay یک شیء Task جدید ایجاد می‌کند. بنابراین، از استفاده از آن در حلقه‌های بسیار فشرده (tight loops) که عملکرد حیاتی است، خودداری کنید.
• دقت زمان‌بندی:Task.Delay تضمین نمی‌کند که دقیقا پس از زمان مشخص شده کامل شود. این یک حداقل تأخیر (minimum delay) است و ممکن است به دلیل بار سیستم یا زمان‌بندی رشته‌ها، کمی بیشتر طول بکشد.
• تأخیرهای بسیار کوتاه: برای تأخیرهای بسیار کوتاه (کمتر از ۱۵ میلی‌ثانیه)، ممکن است استفاده از مکانیزم‌های زمان‌بندی دقیق‌تر یا حتی Thread.Sleep در موارد خاص (جایی که مسدود شدن رشته قابل قبول است و در یک رشته پس‌زمینه اتفاق می‌افتد) کارآمدتر باشد، هرچند این موارد نادر هستند.

• همیشه از await استفاده کنید: همانطور که اشاره شد، عدم استفاده از await باعث می‌شود که Task.Delay به صورت غیرمنتظره‌ای عمل کند.
• استفاده از TimeSpan: به جای استفاده از میلی‌ثانیه به عنوان یک عدد صحیح، استفاده از TimeSpan برای تعیین مدت زمان تأخیر، کد را خواناتر و کمتر مستعد خطا می‌کند.
• استفاده از توکن‌های لغو: در سناریوهایی که تأخیر ممکن است نیاز به لغو شدن داشته باشد (مانند مهلت زمانی)، همیشه از CancellationToken استفاده کنید.
• از Task.Delay(0) اجتناب کنید:Task.Delay(0) به این معنی است که Task بلافاصله پس از زمان‌بندی، تکمیل می‌شود. این معمولاً نشانه‌ای از "بوی کد" (code smell) است و در بیشتر موارد می‌توان به جای آن از Task.Yield() یا صرفاً ادامه اجرای ناهمگام استفاده کرد تا کنترل را به زمان‌بند بازگرداند.
• تأثیر بر عملکرد: همیشه تأثیر Task.Delay را در سناریوهای با فرکانس بالا در نظر بگیرید و در صورت لزوم، راهکارهای جایگزین را بررسی کنید.