MemoryStream در سی‌ شارپ

MemoryStream در سی‌ شارپ

در برنامه‌نویسی، مدیریت داده‌ها یکی از مهم‌ترین بخش‌های توسعه نرم‌افزار محسوب می‌شود.
بسیاری از عملیات مانند خواندن و نوشتن فایل‌ها، ارسال اطلاعات در شبکه، ذخیره‌سازی داده‌های باینری و پردازش تصاویر نیازمند استفاده از جریان‌های داده (Streams) هستند.
در زبان سی‌شارپ، کلاس‌های مختلفی برای کار با Streamها وجود دارد که یکی از کاربردی‌ترین آن‌ها MemoryStream است.

کلاس MemoryStream در فضای نام System.IO قرار دارد و امکان ذخیره و مدیریت داده‌ها را مستقیماً در حافظه (RAM) فراهم می‌کند.
برخلاف FileStream که داده‌ها را روی دیسک ذخیره می‌کند، MemoryStream تمامی اطلاعات را در حافظه نگهداری می‌کند و همین موضوع باعث افزایش سرعت دسترسی به داده‌ها می‌شود.

MemoryStream چیست؟

MemoryStream یک کلاس از کتابخانه System.IO است که به شما اجازه می‌دهد داده‌ها را در قالب یک جریان (Stream) داخل حافظه ذخیره و پردازش کنید.
این کلاس مانند یک فایل مجازی در حافظه عمل می‌کند و می‌توان روی آن عملیات خواندن، نوشتن، جستجو و ویرایش داده انجام داد.

به بیان ساده، زمانی که نمی‌خواهید اطلاعات روی هارد ذخیره شوند و فقط نیاز به پردازش موقت داده‌ها دارید، MemoryStream گزینه‌ای بسیار مناسب خواهد بود.

فضای نام مورد نیاز

برای استفاده از MemoryStream ابتدا باید فضای نام زیر را به پروژه اضافه کنید:

using System.IO;

ایجاد یک MemoryStream ساده

ساده‌ترین روش ایجاد یک شیء از MemoryStream به شکل زیر است:

MemoryStream memoryStream = new MemoryStream();

در این حالت یک جریان خالی در حافظه ایجاد می‌شود که می‌توان داده‌ها را در آن ذخیره کرد.

آیا به دنبال یک فرصت عالی برای یادگیری برنامه‌نویسی هستید؟ 🚀

با دوره آموزشی سی‌شارپ ما، شما می‌توانید مهارت‌های خود را به سطح جدیدی ارتقا دهید! این دوره به‌طور کامل طراحی شده تا به شما کمک کند تا از مبتدی تا پیشرفته در دنیای برنامه‌نویسی سی‌شارپ پیش بروید.

👨‍🏫 چرا دوره ما را انتخاب کنید؟

• محتوای جامع و عملی: با پروژه‌های واقعی و تمرینات عملی، یادگیری را به تجربه‌ای جذاب تبدیل کنید.
• مدرس مجرب: از تجربه و دانش مدرس حرفه‌ای بهره‌مند شوید که شما را در هر مرحله از یادگیری راهنمایی می‌کنند.
• پشتیبانی ۲۴/۷: هر زمان که سوالی داشتید، ما در کنار شما خواهیم بود تا به شما کمک کنیم.
• دسترسی مادام‌العمر: به محتوای دوره دسترسی دائمی داشته باشید و هر زمان که خواستید، می‌توانید به آن مراجعه کنید.

💡 فرصت را از دست ندهید!

بایادگیری سی‌شارپ، می‌توانید در دنیای فناوری اطلاعات به یک متخصص تبدیل شوید و در پروژه‌های جذاب و چالش‌برانگیز شرکت کنید.

همین امروز به جمع یادگیرندگان ما بپیوندید و اولین قدم را به سوی آینده‌ای روشن‌تر بردارید!

شرکت در دوره آموزش برنامه نویسی سی شارپ

نوشتن داده در MemoryStream در سی شارپ

برای ذخیره اطلاعات در MemoryStream معمولاً از متد Write استفاده می‌شود.

مثال:

using System;

using System.IO;

using System.Text;




class Program

{

static void Main()

{

MemoryStream ms = new MemoryStream();




byte[] data = Encoding.UTF8.GetBytes("Hello World");




ms.Write(data, 0, data.Length);




Console.WriteLine("Data Written Successfully");

}

}

در این مثال رشته متنی ابتدا به آرایه بایت تبدیل شده و سپس داخل MemoryStream ذخیره می‌شود.

خواندن داده از MemoryStream در سی شارپ

برای خواندن اطلاعات باید موقعیت جریان را به ابتدای آن منتقل کنیم.

using System;

using System.IO;

using System.Text;




class Program

{

static void Main()

{

MemoryStream ms = new MemoryStream();




byte[] data = Encoding.UTF8.GetBytes("software");




ms.Write(data, 0, data.Length);




ms.Position = 0;




byte[] buffer = new byte[ms.Length];




ms.Read(buffer, 0, buffer.Length);




string result = Encoding.UTF8.GetString(buffer);




Console.WriteLine(result);

}

}

خروجی:

software

استفاده از ToArray در سی شارپ

یکی از پرکاربردترین متدهای MemoryStream، متد () ToArray است که تمامی داده‌های موجود در جریان را به آرایه بایت تبدیل می‌کند.

MemoryStream ms = new MemoryStream();




byte[] data = { 1, 2, 3, 4, 5 };




ms.Write(data, 0, data.Length);




byte[] result = ms.ToArray();

این روش معمولاً برای ارسال داده‌ها به APIها یا ذخیره در پایگاه داده استفاده می‌شود.

ایجاد MemoryStream از آرایه بایت

گاهی داده‌ها از قبل به صورت بایت در اختیار شما قرار دارند و می‌خواهید آن‌ها را داخل یک Stream قرار دهید.

byte[] bytes = { 10, 20, 30, 40 };

MemoryStream ms = new MemoryStream(bytes);

در این حالت داده‌های آرایه مستقیماً در MemoryStream قرار می‌گیرند.

استفاده از StreamWriter همراه MemoryStream

می‌توان برای نوشتن متن از StreamWriter استفاده کرد.

using System;

using System.IO;




class Program

{

static void Main()

{

MemoryStream ms = new MemoryStream();




StreamWriter writer = new StreamWriter(ms);




writer.Write("Welcome To C#");




writer.Flush();




ms.Position = 0;




StreamReader reader = new StreamReader(ms);




Console.WriteLine(reader.ReadToEnd());

}

}

خروجی:

Welcome To C#

استفاده از StreamReader در سی شارپ

برای خواندن داده‌های متنی ذخیره شده در MemoryStream می‌توان از StreamReader استفاده کرد.

MemoryStream ms = new MemoryStream();




StreamWriter sw = new StreamWriter(ms);




sw.Write("Programming");




sw.Flush();




ms.Position = 0;




StreamReader sr = new StreamReader(ms);




string text = sr.ReadToEnd();




Console.WriteLine(text);

کاربرد MemoryStream در پردازش تصاویر

یکی از مهم‌ترین کاربردهای MemoryStream کار با تصاویر است.

فرض کنید تصویری از پایگاه داده دریافت کرده‌اید و به صورت بایت ذخیره شده است.

byte[] imageBytes = File.ReadAllBytes("image.jpg");

MemoryStream ms = new MemoryStream(imageBytes);

اکنون می‌توان تصویر را بدون ذخیره روی دیسک پردازش کرد.

استفاده در ارسال فایل به API

در بسیاری از سرویس‌های وب، فایل‌ها باید به صورت Stream ارسال شوند.

byte[] fileData = File.ReadAllBytes("document.pdf");

MemoryStream ms = new MemoryStream(fileData);

سپس می‌توان این Stream را مستقیماً به درخواست HTTP ارسال کرد.

فشرده‌سازی داده‌ها با MemoryStream در سی شارپ

MemoryStream اغلب در کنار GZipStream استفاده می‌شود.

using System.IO;

using System.IO.Compression;

using System.Text;


string text = "Sample Data";


byte[] data = Encoding.UTF8.GetBytes(text);


MemoryStream output = new MemoryStream();

using (GZipStream gzip =

new GZipStream(output, CompressionMode.Compress))

{

gzip.Write(data, 0, data.Length);

}

در این مثال داده‌ها در حافظه فشرده می‌شوند.

موقعیت جریان (Position) در سی شارپ

خاصیت Position نشان‌دهنده مکان فعلی خواندن یا نوشتن در Stream است.

MemoryStream ms = new MemoryStream();


Console.WriteLine(ms.Position);

برای بازگشت به ابتدای Stream:

ms.Position = 0;

اندازه جریان (Length) در سی شارپ

برای مشاهده حجم داده‌های ذخیره شده:

Console.WriteLine(ms.Length);

ظرفیت حافظه (Capacity) در سی شارپ

Capacity میزان فضای رزرو شده در حافظه را نشان می‌دهد.

Console.WriteLine(ms.Capacity);

این مقدار ممکن است از Length بزرگ‌تر باشد.

پاک کردن اطلاعات MemoryStream در سی شارپ

برای حذف داده‌ها می‌توان از متد SetLength استفاده کرد.

ms.SetLength(0);

یا:

ms = new MemoryStream();

مزایای MemoryStream در سی شارپ

• سرعت بالا

  چون داده‌ها در RAM ذخیره می‌شوند، عملیات خواندن و نوشتن بسیار سریع‌تر از فایل‌ها انجام می‌شود.

• عدم نیاز به فایل فیزیکی

  هیچ فایلی روی دیسک ایجاد نمی‌شود.

• مناسب برای داده‌های موقت

  برای اطلاعاتی که فقط در طول اجرای برنامه نیاز هستند گزینه‌ای عالی محسوب می‌شود.

• سازگاری با سایر Streamها

  به راحتی با StreamReader، StreamWriter، BinaryReader و BinaryWriter کار می‌کند.

• مناسب برای شبکه

  در برنامه‌های تحت شبکه بسیار پرکاربرد است.

معایب MemoryStream در سی شارپ

• مصرف حافظه

  تمام داده‌ها در RAM ذخیره می‌شوند.

• نامناسب برای فایل‌های بسیار بزرگ

  برای فایل‌های چند صد مگابایتی یا گیگابایتی بهتر است از FileStream استفاده شود.

• احتمال افزایش مصرف منابع

  در صورت مدیریت نادرست ممکن است حافظه زیادی اشغال شود.

تفاوت MemoryStream و FileStream  در سی شارپ

استفاده از using  در سی شارپ

برای آزادسازی خودکار منابع بهتر است از using استفاده شود.

using (MemoryStream ms = new MemoryStream())

{

byte[] data = { 1, 2, 3 };




ms.Write(data, 0, data.Length);

}

پس از پایان بلوک using حافظه آزاد خواهد شد.

بهترین زمان استفاده از MemoryStream  در سی شارپ

استفاده از MemoryStream زمانی مناسب است که:

• حجم داده کم یا متوسط باشد.

• داده‌ها موقتی باشند.

• نیاز به سرعت بالا وجود داشته باشد.

• قصد ارسال اطلاعات از طریق API یا شبکه را داشته باشید.

• بخواهید داده‌ها را قبل از ذخیره نهایی پردازش کنید.

• با تصاویر، فایل‌های PDF یا داده‌های باینری کار کنید.
  
  
  

جمع‌بندی

MemoryStream یکی از کلاس‌های قدرتمند و کاربردی در سی‌شارپ است که امکان ذخیره و پردازش داده‌ها را مستقیماً در حافظه فراهم می‌کند.
این کلاس به دلیل سرعت بالا، سادگی استفاده و سازگاری با سایر Streamها در بسیاری از پروژه‌های نرم‌افزاری مورد استفاده قرار می‌گیرد.
از پردازش فایل‌ها و تصاویر گرفته تا ارسال داده در شبکه و ارتباط با APIها، MemoryStream نقش مهمی در مدیریت داده‌های موقت ایفا می‌کند.
با این حال، هنگام کار با حجم زیاد اطلاعات باید به میزان مصرف حافظه توجه داشته باشید و در صورت نیاز از FileStream یا روش‌های دیگر استفاده کنید.