بسم الله الرحمن الرحيم .
السلام عليكم ورحمة الله وبركاته .
نعود بعد انقطاع وهذه المرة مع .NET **** Class Libraries أو الفئات الاساسية في الدوت نت ، موعدنا اليوم مع الفئة System.IO والتي تنظم كافة عمليات الادخال والاخراج والتعامل مع الملفات .
الفئات الاساسية في System.IO :
BinaryReader, BinaryWriter : تتيح لك قراءة وكتابة بياناتك على شكل Binary Files .
BufferedStream : مخزن مؤقت للبيانات Buffer التي يمكن أن تأخذ طريقها لاحقاً إلى الذاكرة .
Directory, DirectoryInfo : مختص بالتعامل مع المجلدات والمعلومات المتعلقة بها .
DriveInfo : مختص بالتعامل ومعرفة المعلومات عن وحدات التخزين في جهازك Driver .
File, FileInfo : مختص بالتعامل مع الملفات وكل ما يتعلق بها .
FileStream : يمكنك من الوصول للملفات وعرض البيانات على شكل Stream .
FileSystemWatcher : مراقبة ملف او مجلد واخبارك بالتعديلات التي تطرأ عليه .
Path : مختص بالتعامل مع المتغيرات النصية لتحويل المسارات إلى صور مفهومة لنظام التشغيل .
StreamWriter, StreamReader : القراءة والكتابة إلى الملفات بصورة نصية .
StringWriter, StringReader : نفس السابق ، فقط مع اختلاف ان ال Reader وال Writter يتم انشاءه من ال String .
هناك فئات اخرى في هذا المجال من الاسماء ، ولكن هذه هي أشهرها وأكثرها استخداماً .
الفوارق بين DirectoryInfo و Directory :
الفارق الأساسي هو في ال structure الخاص بها ، حيث ان Directory مشتقة مباشرة من Object اما DirectoryInfo فهي مشتقة من FileStreamInfo المشتقة بدورها من ال Objects ، اما الفارق في التعامل فهو ان الفئة Directory تعرف دوالها من النوع Static بحيث يمكن استخدامها مباشرة ، اما مع DirectoryInfo فالامر مختلف حيث يتطلب الامر تعريف نسخة قبل استخدام الدوال .
نفس الامر ينطبق بالتبعية على الفرق بين File و FileInfo ...
كلا الفئتين DirectoryInfo و FileInfo تحمل معها الخصائص الاساسية ل FileStreamInfo اضافة لخصائص التعامل مع الملفات والمجلدات ، وهي :
Attributes : تختص بتمرير قيم اضافية للمجلد أو الملف عن طريق ال enumeration المسمى FileAttributes .
CreationTime : قراءة وكتابة تاريخ الانشاء .
Exists : معرفة هل الملف موجود أم لا .
Extension : تعيد امتداد الملف .
FullName : الحصول على المسار كاملاً للملف أو للمجلد .
LastAccessTime : قراءة وكتابة آخر تاريخ للدخول على الملف او المجلد .
LastWriteTime : قراءة وكتابة آخر تاريخ للكتابة في هذا الملف او المجلد .
Name : معرفة اسم الملف أو المجلد .
الفئة DirectoryInfo :
اضافة لاحتواءها على الخصائص السابقة من FileStreamInfo ، تحتوي هذه الفئة على الدوال التالية :
Create(), CreateSubdirectory() : انشاء مجلد او مجلد فرعي في المسار المحدد .
Delete() : حذف المجلد وكامل محتوياته .
GetDirectories() : تعيد مصفوفة من الاسماء توضح اسماء المجلدات الفرعية .
GetFiles() : تعيد مصفوفة Array من FileInfo تحتوي على كافة الملفات الموجودة في هذا المجلد .
MoveTo() : نقل المجلد وكافة محتوياته إلى مكان جديد .
Parent : معرفة المجلد الاكبر من هذا المجلد .
Root : لمعرفة ال Driver الخاص بهذا المجلد .
قبل البدء ، انت بحاجة لتعريف نسخة من هذه الفئة ، يمكنك تمرير المكان الذي تود البدء منه في المشيد Constructor بالشكل التالي مثلاً ( لمسار البرنامج ) :
C#:
كود PHP:
DirectoryInfo dir1 = new DirectoryInfo(".");
vb.net:
كود PHP:
Dim dir1 As New DirectoryInfo(".")
او إلى مسار عادي :
C#:
كود PHP:
DirectoryInfo dir1 = new DirectoryInfo("C:\Ahmed");
vb.net:
كود PHP:
Dim dir1 As New DirectoryInfo("C:\Ahmed")
*** لو كنت مبرمج سي شارب فلا بد من عدم وضع \ وحدها داخل علامات التنصيص لإن لها استخدامات أخرى مثل \n \r وخلافه ، لكن يمكنك تحديد نوع البيانات بالداخل بأنها مباشرة عن طريق اضافة @ بالشكل التالي مثلاً :
كود PHP:
DirectoryInfo dir1 = new DirectoryInfo(@"C:\Ahmed");
ليس فقط بامكانك الربط مع مجلد موجود ، بل يمكنك الربط إلى مجلد غير موجود ومن ثم انشاءه :
C#:
كود PHP:
DirectoryInfo dir1 = new DirectoryInfo(@"C:\Ahmed\Test");
dir1.Create();
vb.net:
كود PHP:
Dim dir1 As New DirectoryInfo("C:\Ahmed\Test")
dir1.Create()
يمكنك ايضاً استعراض كافة الملفات داخل المجلد :
C#:
كود PHP:
FileInfo[] imageFiles = dir.GetFiles();
vb.net:
كود PHP:
Dim imageFiles As FileInfo() = dir.GetFiles()
يمكنك استخدام خصائص FileSystemInfo التي تحتوي على كافة المعلومات المتعلقة بالمجلد ، فمثلاً لعرض تاريخ إنشاء المجلد :
C#:
كود PHP:
Console.WriteLine(dir1.CreationTime);
vb.net:
كود PHP:
Console.WriteLine(dir1.CreationTime)
او يمكنك استعراض ملفات من نوع معين فقط ، مثلاً لاستعراض الملفات النصية فقط GIF ومن ثم كتابتها ، لا تنس ان الناتج من نوع FileInfo ويمكن تطبيق خصائص FileSsystemInfo عليها .
C#:
كود PHP:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;
namespace ConsoleApplication7
{
class Program
{
static void Main(string[] args)
{
DirectoryInfo dir1 = new DirectoryInfo(@"C:\Users\Ahmed\********s\Visual Studio 2008\WebSites\WebSite4");
FileInfo[] imageFiles = dir1.GetFiles("*.gif");
foreach (FileInfo f in imageFiles)
{
Console.WriteLine("Name: {0} - Creation Date: {1} . \n\n", f.Name, f.CreationTime);
}
Console.ReadKey();
}
}
}
vb.net:
كود PHP:
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.IO
Namespace ConsoleApplication7
Class Program
Private Shared Sub Main(ByVal args As String())
Dim dir1 As New DirectoryInfo("C:\Users\Ahmed\********s\Visual Studio 2008\WebSites\WebSite4")
Dim imageFiles As FileInfo() = dir1.GetFiles("*.gif")
For Each f As FileInfo In imageFiles
Console.WriteLine("Name: {0} - Creation Date: {1} . " & Chr(10) & "" & Chr(10) & "", f.Name, f.CreationTime)
Next
Console.ReadKey()
End Sub
End Class
End Namespace
الناتج سيكون بالشكل التالي مثلاً :
التعامل مع الفئة Directory
لا شيء جديد ، فقط ستفقد الخصائص المتاحة من خلال الفئة FileSystemInfo وفي المقابل لن تكون محتاجاً لتعريف نسخة قبل البدء بالعمل ، لذا يمكنك العمل على الفئة مباشرة بالشكل التالي مثلاً لعملية الحذف :
C#:
كود PHP:
System.IO.Directory.Delete(@"C:\ahmed");
vb.net:
System.IO.Directory.Delete("C:\ahmed")
التعامل مع الفئة DriveInfo :
تتيح لك هذه الفئة استعراض ال Drivers في جهازك ومعرفة بعض المعلومات عنها ، هذا المثال مباشرة من كتاب Pro.CSharp 2008 :
C#:
كود PHP:
Console.WriteLine("***** Fun with DriveInfo *****\n");
// Get info regarding all drives.
DriveInfo[] myDrives = DriveInfo.GetDrives();
// Now print drive stats.
foreach(DriveInfo d in myDrives)
{
Console.WriteLine("Name: {0}", d.Name);
Console.WriteLine("Type: {0}", d.DriveType);
// Check to see whether the drive is mounted.
if (d.IsReady)
{
Console.WriteLine("Free space: {0}", d.TotalFreeSpace);
Console.WriteLine("Format: {0}", d.DriveFormat);
Console.WriteLine("Label: {0}", d.VolumeLabel);
Console.WriteLine();
}
}
Console.ReadLine();
vb.net:
كود PHP:
Console.WriteLine("***** Fun with DriveInfo *****" & Chr(10) & "")
' Get info regarding all drives.
Dim myDrives As DriveInfo() = DriveInfo.GetDrives()
' Now print drive stats.
For Each d As DriveInfo In myDrives
Console.WriteLine("Name: {0}", d.Name)
Console.WriteLine("Type: {0}", d.DriveType)
' Check to see whether the drive is mounted.
If d.IsReady Then
Console.WriteLine("Free space: {0}", d.TotalFreeSpace)
Console.WriteLine("Format: {0}", d.DriveFormat)
Console.WriteLine("Label: {0}", d.VolumeLabel)
Console.WriteLine()
End If
Next
Console.ReadLine()
التعامل مع FileInfo :
الدوال الرئيسية في هذه الفئة - اضافة بالطبع للخصائص العادية - :
AppendText() : انشاء StreamWritter للكتابة في الملف
CopyTo() نسخ .
Create() انشاء ملف واعادة كائن FileStream
CreateText() : انشاء StreamWriter للكتابة في الملف
Delete() : حذف الملف
Directory : معرفة اسم المجلد
DirectoryName : معرفة مسار المجلد
Length : معرفة حجم الملف
MoveTo() : النقل ، يمكنك تحديد اسم جديد للملف المنقول
Name : اسم الملف
Open() : فتح الملف مع امكانية القراءة والكتابة وخلافه
OpenRead() : فتح الملف للقراءة فقط
OpenText() : فتح الملف باستخدام StreamReader
OpenWrite() : فتح الملف للكتابة فقط
بعيداً عن خواص StreamReader والتي سنتعرف عليها تفصيلاً في جزء لاحق من هذه الدروس . سنتعرف على باقي الخصائص .
لانشاء ملف مثلاً باستخدام Create :
C#:
كود PHP:
FileInfo f = new FileInfo(@"C:\Test.txt");
FileStream fs = f.Create();
vb.net:
رمز:
Dim f As New FileInfo("C:\Test.txt")
Dim fs As FileStream = f.Create()
طبعاً لا تنس أن بامكانك استخدام أي من الخصائص الموجودة في FileSystemInfo كما سبق ، فقط الخاصية Attributes هي خاصية مميزة نوعاً ما حيث تشمل عدة تفاصيل ، حيث يمكنك من خلالها تحديد إذا كان الملف مخفي ام ظاهر ، للقراءة فقط ... الخ .
مثلاً لمعرفة هل الملف مخفي أم لا ؟
C#:
كود PHP:
if ((File.GetAttributes(path) & FileAttributes.Hidden) == FileAttributes.Hidden)
vb.net:
كود PHP:
If (File.GetAttributes(path) And FileAttributes.Hidden) = FileAttributes.Hidden Then
أما لاخفاء الملف نستخدم المعامل OR بالشكل التالي مثلاً :
C#:
كود PHP:
File.SetAttributes(path, File.GetAttributes(path) | FileAttributes.Hidden);
vb.net:
كود PHP:
File.SetAttributes(path, File.GetAttributes(path) Or FileAttributes.Hidden)
انشاء وفتح الملفات باستخدام Open :
في الكود التالي ستجد اننا نستخدم الدالة Open مع الخاصية FileMode.OpenOrCreate وهي ما تفيد انه لو وجدت الملف قم بفتحه ، لو لم تجده قم بانشاءه :
C#:
كود PHP:
FileInfo f2 = new FileInfo(@"C:\Test2.txt");
FileStream fs2 = f2.Open(FileMode.OpenOrCreate,FileAccess.ReadWrite, FileShare.None);
VB.net:
كود PHP:
Dim f2 As New FileInfo("C:\Test2.txt")
Dim fs2 As FileStream = f2.Open(FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None)
هناك حالات أخرى أيضاً لفتح وانشاء الملفات :
CreateNew : انشأ ملف جديد مباشرة ، لو وجدته قم بعمل خطأ IOException
Create : قم بانشاء ملف ولو وجدته قم بانشاءه فوق الموجود .
Open افتح الملف ولو لم تجده قم بعمل خطأ FileNotFoundException
OpenOrCreate : افتح الملف لو كان موجود أو انشأه لو لم يكن موجوداً .
Truncate : افتح الملف وامسح كافة محتوياته
Append : قم بفتح الملف وانتقل لآخره لبدء عملية الكتابة ، لو لم يكن الملف موجوداً قم بفتح واحد جديد والبدء بالكتابة من أوله ، عموماً هي لا تظهر في حالة الفتح باستخدام Open وإنما فقط في حالة OpenWrite .
ال FileAccess ايضاً له ثلاث حالات مجموعة في هذا ال enum .
كود PHP:
public enum FileAccess
{
Read,
Write,
ReadWrite
}
ال FileShare أيضاً :
كود PHP:
public enum FileShare
{
None,
Read,
Write,
ReadWrite
}
فتح وانشاء الملفات باستخدام OpenRead و OpenWrite :
مثل ما سبق ، عدا انك ستكون ملزماً بنوع واحد فقط من العمليات .
فتح الملفات باستخدام OpenText :
الفارق الوحيد هو ان القيمة المعادة تكون من نوع StreamReader وليس FileStream ، بالشكل التالي مثلاً :
C#:
كود PHP:
FileInfo f5 = new FileInfo(@"C:\boot.ini");
StreamReader sreader = f5.OpenText();
vb.net:
كود PHP:
Dim f5 As New FileInfo("C:\boot.ini")
Dim sreader As StreamReader = f5.OpenText()
الفتح باستخدام CreateText و AppendText :
مثل السابقة ، الفارق فقط يمكن ان القيمة المعادة ستكون من نوع StreamWritter .
كود PHP:
التعامل مع الفئة File :
نفس ما ذكرنا في حالة المجلدات ، لن تكون مجبراً على تعريف نسخة منها نظراً لإنها Static بل يمكنك العمل عليها مباشرة .
هناك دوال أخرى جديدة في الفئة لعمليات القراءة والكتابة هي :
ReadAllBytes() : قراءة البيانات على شكل array of bytes
ReadAllLines() : قراءة البيانات على شكل مصفوفة من الاسطر .
ReadAllText() : قراءة جميع البيانات كتلة واحدة .
WriteAllBytes() : كتابة byte by byte
WriteAllLines() : الكتابة على شكل اسطر .
WriteAllText() : الكتابة ككتلة واحدة .
ويمكن استخدامهم بالشكل التالي مثلاً - من كتاب ProCSharp 2008:
C#:
كود PHP:
string[] myTasks = {
"Fix bathroom sink", "Call Dave",
"Call Mom and Dad", "Play Xbox 360"};
// Write out all data to file on C drive.
File.WriteAllLines(@"C:\tasks.txt", myTasks);
// Read it all back and print out.
foreach (string task in File.ReadAllLines(@"C:\tasks.txt"))
{
Console.WriteLine("TODO: {0}", task);
}
vb.net:
كود PHP:
Dim myTasks As String() = {"Fix bathroom sink", "Call Dave", "Call Mom and Dad", "Play Xbox 360"}
' Write out all data to file on C drive.
File.WriteAllLines("C:\tasks.txt", myTasks)
' Read it all back and print out.
For Each task As String In File.ReadAllLines("C:\tasks.txt")
Console.WriteLine("TODO: {0}", task)
Next
معلومة اضافية :
*** في .net ، يمكن للفئة إذا كانت implemented ل IDisposable ان نقوم بتعريفها في مكان ومن ثم حذفها خارج هذا النطاق بالشكل التالي مثلاً :
C#:
كود PHP:
using (CarClass newCare)
{
// do operations
}
vb.net:
كود PHP:
Using newCare As CarClass
' do operations
End Using
لذا سنحاول استخدامها ايضاً مع الملفات حتى لا تبقى معلقة في الذاكرة بالشكل التالي مثلاً :
C#:
كود PHP:
FileInfo f = new FileInfo(@"C:\test.txt");
using(StreamReader reader = f.OpenText())
{
// code here
}
vb.net:
كود PHP:
Dim f As New FileInfo("C:\test.txt")
Using reader As StreamReader = f.OpenText()
' code here
End Using
إلى هنا نكون قد انتهينا من دروس هذا اليوم ، نواصل غداً إن شاء الله مع دروس Stream .
والله الموفق ...
والسلام عليكم ورحمة الله وبركاته .