‫ArrayPool: مدیریت هوشمند حافظه و کلید عملکرد فوق‌العاده در دات‌نت

async Task ProcessStreamAsync(Stream stream)
{
    // 1. یک بافر از استخر اجاره می‌کنیم
    byte[] buffer = ArrayPool<byte>.Shared.Rent(4096); 

    try
    {
        int bytesRead;
        while ((bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length)) > 0)
        {
            // با داده‌های خوانده شده در بافر کار می‌کنیم
            // نکته مهم: فقط باید با `bytesRead` بایت اول بافر کار کنیم
            ProcessData(buffer, bytesRead);
        }
    }
    finally
    {
        // 2. بافر را به استخر بازمی‌گردانیم
        ArrayPool<byte>.Shared.Return(buffer);
    }
}

void ProcessData(byte[] data, int length)
{
    // پردازش داده‌ها...
    Console.WriteLine($"Processing {length} bytes.");
}

• اجاره (Renting): با فراخوانی ArrayPool، ما یک آرایه از نوع byte با حداقل طول ۴۰۹۶ درخواست می‌کنیم. نکته بسیار مهم این است که ArrayPoolتضمین نمی‌کند آرایه‌ای با طول دقیقاً ۴۰۹۶ برگرداند؛ ممکن است آرایه‌ای بزرگ‌تر (مثلاً با طول ۸۱۹۲) از استخر موجود به شما تحویل دهد. بنابراین، هرگز نباید به buffer.Length به عنوان طول واقعی داده‌های معتبر خود اتکا کنید. همیشه باید از متغیری مانند bytesRead برای دانستن طول دقیق داده‌هایتان استفاده نمایید.
• بازگرداندن (Returning): بلوک try...finally تضمین می‌کند که حتی اگر خطایی در حین پردازش داده‌ها رخ دهد، متد Return همیشه فراخوانی شده و بافر به استخر بازگردانده می‌شود. فراموش کردن بازگرداندن بافر منجر به "نشت حافظه" (Memory Leak) در استخر شده و مزایای استفاده از آن را از بین می‌برد.

async Task ProcessStreamWithSpanAsync(Stream stream)
{
    byte[] buffer = ArrayPool<byte>.Shared.Rent(4096);

    try
    {
        int bytesRead;
        while ((bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length)) > 0)
        {
            // یک Span فقط برای بخش معتبر داده ایجاد می‌کنیم
            Span<byte> validDataSpan = new Span<byte>(buffer, 0, bytesRead);

            // حالا متد ما یک Span دریافت می‌کند که هم امن‌تر است و هم کارآمدتر
            ProcessData(validDataSpan);
        }
    }
    finally
    {
        ArrayPool<byte>.Shared.Return(buffer);
    }
}

void ProcessData(Span<byte> data)
{
    // دیگر نگران طول آرایه اصلی نیستیم. data.Length همیشه صحیح است.
    Console.WriteLine($"Processing {data.Length} bytes safely.");
}

• فراموش کردن بازگرداندن آرایه: این کار باعث نشت حافظه در استخر می‌شود. همیشه از بلوک try...finally استفاده کنید.
• بازگرداندن یک آرایه بیش از یک بار (Double Return): این یک خطای جدی است که می‌تواند باعث خرابی داده (Data Corruption) شود، زیرا استخر ممکن است همان آرایه را به بخش دیگری از برنامه شما اجاره دهد در حالی که شما هنوز به آن دسترسی دارید.
• استفاده از آرایه پس از بازگرداندن (Use After Return): این نیز مشابه مورد قبل، می‌تواند منجر به نتایج غیرمنتظره و خرابی داده شود.
• اتکا به طول آرایه اجاره شده: همانطور که تاکید شد، همیشه از طول واقعی داده‌های خود استفاده کنید، نه array.Length. استفاده از Span بهترین راه برای جلوگیری از این خطاست.

public byte[] GetProcessedImage(byte[] rawImage)
{
    var processingBuffer = ArrayPool<byte>.Shared.Rent(rawImage.Length * 2);
    try
    {
        // فرض کنید این متد تصویر را پردازش کرده و نتیجه را در بافر می‌نویسد
        // و طول نهایی تصویر پردازش شده را برمی‌گرداند
        int finalSize = HeavyImageProcessing(rawImage, processingBuffer);

        var result = new byte[finalSize];
        Buffer.BlockCopy(processingBuffer, 0, result, 0, finalSize);
        return result;
    }
    finally
    {
        ArrayPool<byte>.Shared.Return(processingBuffer);
    }
}