التعامل مع تنزيلات الملفات في ASP.NET Core Web API

عند محاولة إرجاع ملف من وحدة تحكم ASP.NET Web API، قد تواجه مشكلات مع يتم التعامل مع الاستجابة على أنها JSON. لحل هذه المشكلة، من الضروري فهم الطريقة الصحيحة لتنزيل الملف في ASP.NET Core.

لإرجاع ملف في ASP.NET Core Web API، تحتاج إلى إرجاع IActionResult مشتق بدلاً من HttpResponseMessage. سيقوم إطار العمل بتفسير HttpResponseMessage كنموذج، مما يؤدي إلى مشكلة استجابة JSON.

يوجد أدناه مثال رمز محدث يوضح كيفية إرجاع ملف باستخدام IActionResult:

[Route("api/[controller]")]
public class DownloadController : Controller
{
    // GET api/download/12345abc
    [HttpGet("{id}")]
    public async Task Download(string id)
    {
        Stream stream = await GetStreamBasedOnIdAsync(id);

        if (stream == null)
            return NotFound(); // Returns a NotFoundResult with Status404NotFound response

        return File(stream, "application/octet-stream", $"{FileName}.{FileExtension}"); // Returns a FileStreamResult
    }
}

ملاحظة: لا تستخدم عبارة استخدام للتيار؛ وإلا فسيتم التخلص منها قبل إرسال الاستجابة، مما يؤدي إلى حدوث استثناء أو استجابة تالفة. سيتعامل إطار العمل مع التخلص من الدفق تلقائيًا عند اكتمال الاستجابة.