آموزش سی شارپ - فایل ها

یک فایل (file) مجموعه‌ای از داده‌ها است که با یک نام خاص و مسیر دایرکتوری در دیسک ذخیره می‌شود. هنگامی که یک فایل برای خواندن یا نوشتن باز می‌شود، به یک جریان (stream) تبدیل می‌شود.

جریان اصلاحاً توالی بایت‌هایی است که از طریق مسیر ارتباطی می‌گذرد. دو جریان اصلی وجود دارند: جریان ورودی (input stream) و جریان خروجی (output stream). جریان ورودی برای خواندن داده‌ها از فایل (عملیات خواندن) استفاده می‌شود و جریان خروجی برای نوشتن در فایل (عملیات نوشتن) استفاده می‌شود.

کلاس‌های ورود و خروج فایل در C#

فضای‌نام System.IO دارای کلاس‌های مختلفی است که برای انجام عملیات‌های مختلف با فایلها استفاده می‌شوند، از جمله ایجاد و حذف فایلها، خواندن از یک فایل و نوشتن در یک فایل، بستن فایل و غیره.

جدول زیر نمایشی از برخی از کلاس‌های غیر انتزاعی رایج در فضای‌نام System.IO را نشان می‌دهد:

کلاس FileStream

کلاس FileStream در فضای‌نام System.IO در خواندن از و نوشتن به فایلها کمک می‌کند و فایلها را می بندد. این کلاس از کلاس انتزاعی Stream مشتق می‌شود.

برای ایجاد یک فایل جدید یا باز کردن یک فایل موجود، شما باید یک شیء FileStream ایجاد کنید. ساختار ایجاد شیء FileStream به صورت زیر است:

FileStream <object_name> = new FileStream( <file_name>, <FileMode Enumerator>,
   <FileAccess Enumerator>, <FileShare Enumerator>);

به عنوان مثال، ما یک شیء FileStream با نام F برای خواندن یک فایل به نام sample.txt را ایجاد می‌کنیم که نشان داده شده است −

FileStream F = new FileStream("sample.txt", FileMode.Open, FileAccess.Read,
   FileShare.Read);

مثال

برنامه زیر استفاده از کلاس FileStream را نشان می‌دهد −

using System;
using System.IO;

namespace FileIOApplication {
   class Program {
      static void Main(string[] args) {
         FileStream F = new FileStream("test.dat", FileMode.OpenOrCreate, 
            FileAccess.ReadWrite);
         
         for (int i = 1; i <= 20; i++) {
            F.WriteByte((byte)i);
         }
         F.Position = 0;
         for (int i = 0; i <= 20; i++) {
            Console.Write(F.ReadByte() + " ");
         }
         F.Close();
         Console.ReadKey();
      }
   }
}

هنگامی که کد بالا کامپایل و اجرا می شود، نتیجه زیر را ایجاد می کند -

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 -1

عملیات پیشرفته فایل در C#

مثال پیشین عملیات ساده فایل را در C# ارائه می‌دهد. اما برای بهره‌برداری از قدرت‌های فراوان کلاس‌های System.IO در C#، باید خواص و روش‌های رایج این کلاس‌ها را بشناسید.

خواندن از و نوشتن به فایل‌های متنی در C#

کلاس‌های StreamReader و StreamWriter برای خواندن از و نوشتن داده‌ها به فایل‌های متنی استفاده می‌شوند. این کلاس‌ها از کلاس پایه انتزاعی Stream ارث‌بری می‌کنند که از خواندن و نوشتن بایت‌ها به یک جریان فایل پشتیبانی می‌کند.

کلاس StreamReader

کلاس StreamReader همچنین از کلاس پایه انتزاعی TextReader که یک خواننده برای خواندن سری کاراکترها را نمایش می‌دهد، ارث‌بری می‌کند. جدول زیر توضیحی از برخی از متدهای معمول کلاس StreamReader را نشان می‌دهد:

مثال

مثال زیر نحوه خواندن یک فایل متنی با نام Jamaica.txt را نمایش می‌دهد. محتوای فایل به صورت زیر است:

Down the way where the nights are gay
And the sun shines daily on the mountain top
I took a trip on a sailing ship
And when I reached Jamaica
I made a stop

using System;
using System.IO;

namespace FileApplication {
   class Program {
      static void Main(string[] args) {
         try {
            // Create an instance of StreamReader to read from a file.
            // The using statement also closes the StreamReader.
            using (StreamReader sr = new StreamReader("c:/jamaica.txt")) {
               string line;

               // Read and display lines from the file until 
               // the end of the file is reached. 
               while ((line = sr.ReadLine()) != null) {
                  Console.WriteLine(line);
               }
            }
         } catch (Exception e) {
            // Let the user know what went wrong.
            Console.WriteLine("The file could not be read:");
            Console.WriteLine(e.Message);
         }
         Console.ReadKey();
      }
   }
}

حدس بزنید که وقتی برنامه را کامپایل و اجرا می‌کنید چه نتیجه‌ای نمایش داده می‌شود!

کلاس StreamWriter

کلاس StreamWriter از کلاس انتزاعی TextWriter که یک نویسنده را نمایش می‌دهد و می‌تواند سری کاراکترها را بنویسد، ارث‌بری می‌کند.

جدول زیر توضیحی از متدهای معمول این کلاس را نشان می‌دهد:

برای لیست کاملی از متدها، می توانید به مستندات C# شرکت Microsoft مراجعه کنید.

مثال

مثال زیر نحوه نوشتن داده‌های متنی به یک فایل با استفاده از کلاس StreamWriter را نشان می‌دهد:

using System;
using System.IO;

namespace FileApplication {
   class Program {
      static void Main(string[] args) {
         string[] names = new string[] {"Sara", "Smith"};
         
         using (StreamWriter sw = new StreamWriter("names.txt")) {

            foreach (string s in names) {
               sw.WriteLine(s);
            }
         }
         
         // Read and show each line from the file.
         string line = "";
         using (StreamReader sr = new StreamReader("names.txt")) {
            while ((line = sr.ReadLine()) != null) {
               Console.WriteLine(line);
            }
         }
         Console.ReadKey();
      }
   }
}

هنگامی که کد بالا کامپایل و اجرا می شود، نتیجه زیر را ایجاد می کند -

Sara
Nuha

خواندن از و نوشتن به فایل‌های باینری

کلاس‌های BinaryReader و BinaryWriter برای خواندن از و نوشتن به فایل‌های باینری استفاده می‌شوند.

کلاس BinaryReader

کلاس BinaryReader برای خواندن داده‌های باینری از یک فایل استفاده می‌شود. یک شیء BinaryReader با ارسال یک شیء FileStream به سازنده‌اش ایجاد می‌شود.

جدول زیر شرح متد‌های معمول استفاده شده در کلاس BinaryReader را توضیح می‌دهد.

کلاس BinaryWriter

کلاس BinaryWriter برای نوشتن داده‌های باینری به یک جریان استفاده می‌شود. یک شیء BinaryWriter با ارسال یک شیء FileStream به سازنده‌اش ایجاد می‌شود.

جدول زیر شرح متد‌های معمول استفاده شده در کلاس BinaryWriter را توضیح می‌دهد.

برای مشاهده لیست کاملی از متدها، لطفاً به مستندات Microsoft C# مراجعه کنید.

مثال

مثال زیر نحوه خواندن و نوشتن داده‌های باینری را نشان می‌دهد -

using System;
using System.IO;

namespace BinaryFileApplication {
   class Program {
      static void Main(string[] args) {
         BinaryWriter bw;
         BinaryReader br;
         
         int i = 25;
         double d = 3.14157;
         bool b = true;
         string s = "I am happy";
         
         //create the file
         try {
            bw = new BinaryWriter(new FileStream("mydata", FileMode.Create));
         } catch (IOException e) {
            Console.WriteLine(e.Message + "\n Cannot create file.");
            return;
         }
         
         //writing into the file
         try {
            bw.Write(i);
            bw.Write(d);
            bw.Write(b);
            bw.Write(s);
         } catch (IOException e) {
            Console.WriteLine(e.Message + "\n Cannot write to file.");
            return;
         }
         bw.Close();
         
         //reading from the file
         try {
            br = new BinaryReader(new FileStream("mydata", FileMode.Open));
         } catch (IOException e) {
            Console.WriteLine(e.Message + "\n Cannot open file.");
            return;
         }
         
         try {
            i = br.ReadInt32();
            Console.WriteLine("Integer data: {0}", i);
            d = br.ReadDouble();
            Console.WriteLine("Double data: {0}", d);
            b = br.ReadBoolean();
            Console.WriteLine("Boolean data: {0}", b);
            s = br.ReadString();
            Console.WriteLine("String data: {0}", s);
         } catch (IOException e) {
            Console.WriteLine(e.Message + "\n Cannot read from file.");
            return;
         }
         br.Close();
         Console.ReadKey();
      }
   }
}

هنگامی که کد بالا کامپایل و اجرا می شود، نتیجه زیر را ایجاد می کند -

Integer data: 25
Double data: 3.14157
Boolean data: True
String data: I am happy

C# - سیستم فایل ویندوز

C# به شما امکان می‌دهد با استفاده از کلاس‌های مربوط به دایرکتوری و فایل مختلف مانند کلاس DirectoryInfo و کلاس FileInfo با فایل‌ها و دایرکتوری‌ها کار کنید.

کلاس DirectoryInfo

کلاس DirectoryInfo از کلاس FileSystemInfo مشتق می‌شود. این کلاس دارای روش‌های مختلف برای ایجاد، جابجایی و مرور در دایرکتوری‌ها و زیردایرکتوری‌ها است. این کلاس قابل مشتق شدن نیست.

در زیر تعدادی از ویژگی‌های معمول این کلاس آمده است −

در زیر تعدادی از روش‌های معمول این کلاس آمده است −

برای مشاهدهٔ لیست کاملی از ویژگی‌ها و روش‌ها، لطفاً به مستندات C# شرکت مایکروسافت مراجعه کنید.

کلاس FileInfo

کلاس FileInfo از کلاس FileSystemInfo مشتق می‌شود. این کلاس دارای ویژگی‌ها و روش‌های نمونه برای ایجاد، کپی، حذف، جابجایی و باز کردن فایل‌ها است و در ایجاد شی‌های FileStream نیز کمک می‌کند. این کلاس قابل مشتق شدن نیست.

در زیر تعدادی از ویژگی‌های معمول این کلاس آمده است −

در زیر تعدادی از روش‌های معمول کلاس FileInfo آمده است −

برای دیدن لیست کاملی از ویژگی‌ها و روش‌ها، لطفاً به مستندات C# مایکروسافت مراجعه کنید.

مثال

مثال زیر استفاده از کلاس‌های فوق را نشان می‌دهد −

using System;
using System.IO;

namespace WindowsFileApplication {
   class Program {
      static void Main(string[] args) {
         //creating a DirectoryInfo object
         DirectoryInfo mydir = new DirectoryInfo(@"c:\Windows");
         
         // getting the files in the directory, their names and size
         FileInfo [] f = mydir.GetFiles();
         foreach (FileInfo file in f) {
            Console.WriteLine("File Name: {0} Size: {1}", file.Name, file.Length);
         }
         
         Console.ReadKey();
      }
   }
}

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