‫آشنایی با Stream Adapterهای جدید در دات‌نت 11: پلی میان داده‌های درون‌حافظه‌ای و دنیای Stream

byte[] bytes = Encoding.UTF8.GetBytes(someString);
using var stream = new MemoryStream(bytes);

using System.IO;
using System.Text;

// ارسال مستقیم یک رشته به APIای که Stream می‌پذیرد؛ بدون نیاز به byte[] واسط
using Stream config = new StringStream(yamlText, Encoding.UTF8);
var settings = ParseConfiguration(config);

// نمایش یک بافر موجود به‌صورت یک Stream فقط‌خواندنی؛ مثلاً به‌عنوان بدنه‌ی درخواست HTTP
ReadOnlyMemory<byte> payload = GetPayload();
using Stream body = new ReadOnlyMemoryStream(payload);
await httpClient.PostAsync(uri, new StreamContent(body));

// فرض کنید buffer از یک PipeReader خوانده شده است
ReadOnlySequence<byte> buffer = readResult.Buffer;
using Stream sequenceStream = new ReadOnlySequenceStream(buffer);
await sequenceStream.CopyToAsync(destination);

• این کلاس‌ها جایگزین MemoryStream در همه‌ی سناریوها نیستند. اگر به یک Stream نیاز دارید که بتواند به‌صورت پویا رشد کند (مثلاً برای Buffer کردن خروجی با حجم نامشخص)، MemoryStream همچنان انتخاب درستی است. این چهار کلاس بیشتر برای سناریوهایی طراحی شده‌اند که داده از پیش کامل و مشخص است و صرفاً نیاز به «قالب‌بندی» آن به شکل Stream دارید.
• مدیریت طول عمر حافظه اهمیت دارد. از آنجا که این کلاس‌ها داده را کپی نمی‌کنند، بلکه مستقیماً به بافر اصلی اشاره دارند، باید مطمئن شوید بافر پشتیبان (مثلاً Memory یا ReadOnlySequence) در طول عمر Stream معتبر و بدون تغییر باقی می‌ماند؛ در غیر این صورت ممکن است داده‌ی خوانده‌شده نادرست یا غیرقابل‌پیش‌بینی باشد.
• سازگاری با الگوهای Async و Span-based API. این کلاس‌ها معمولاً متدهای مدرن Stream نظیر ReadAsync(Memory و Read(Span را نیز پیاده‌سازی می‌کنند، بنابراین در کنار APIهای جدید دات‌نت که مبتنی بر Span و Memory هستند، به‌خوبی ترکیب می‌شوند و از تبدیل‌های غیرضروری بین آرایه و Span جلوگیری می‌کنند.
• کاهش فشار بر Garbage Collector. در برنامه‌های با کارایی بالا (High-Throughput)، مانند سرویس‌های ASP.NET Core که حجم زیادی داده‌ی HTTP پردازش می‌کنند، حذف تخصیص‌های واسط (مثل کپی رشته به آرایه بایت) می‌تواند به‌طور محسوسی فشار روی Garbage Collector را کاهش داده و تأخیر (Latency) را بهبود بخشد.