مراقبة المجلدات و الملفات بإستخدام FileSystemWatcher - الجزء الأول

[iAGx]

ملاحظ : رجاء رجاء إحنا هنا في صرح علمي لسنا في منتديات اجتماعية ..! , انت لا تعلم مقدار الجهد المبذول في كتابة هذه المقالة حتى تخرج لك بهذا الأسلوب من التنسيق و المحتوى التقني و انا لا أدعي كمالها و لكن على الاقل افضل من لا شيء , لديك تعليق يطور المقالة و يزيد من معلومات القارء و يصحح ما وقعت به من أخطاء تفضل سأكون لك من أول الشاكرين , أنا لدي هدفين من هذه المقالة توصيل المعلومة و ثاني زيادة المحتوى العلمي للمنتدى و ليس زيادة عدد مشاركتي , تريد شكري عندك زر شكرا اسفل المقالة , ما عندك شي فقط اكتفي بالقراءة . لا تزيد عددد الردود على كلام فارغ , و كلام لا يسمن و لا يغني من جوع .

• مقدمة سريعة .
• الأداة و و فضاء الاسماء IO و VS 2003 - VS2005 .
• الطرق و الأحداث و الخصائص .
• مثال لمراقبة مجلد المفضلة .

المقدمة :

السلام عليكم , العديد منا لديه مجلدات أو ملفات لا يرغب بأن يحدث لديها أية تعديلات البعض منا و يرغب براقبة تلك الملفات و الملجلدات خوفا من حدث أية تغيرات عليها مثل الإضافة أو الحذف أو التعديل و غيرها من الأمور , أوقد ترغب بمعرفة اخر شخص قام باستخدام الملف أو ادخول على المجلد و اخر عملية كتابة أو قراءة منه . قد مثلا إذا حدث أية عملية تغيرات على المجلد أو الملفا أنترجعة إلى حالته الأصلية كما يفعل برنامج ديب فريز مثلا .

أحاول في هذه المقالة أن أتطرق لمفهوم مراقبة المجلدات و الملفات عن طريق الأداة FileSystemWatcher , طرق و أحداث و خصائص الإداة و طريقة الاستجابة للإحداث بناء على التغيرات .

الأداة و و فضاء الاسماء IO و VS 2003 - VS2005 :

ظهرت الأداة على حد علمي و مع مكتبة DotNetFramwark2.0 أية تقريبا منذ ظهور VS2005 المشكلة أنها لم تكن موجودة في شريط الأدوات و لست متأكد من هذه المعلومة لأني أعمل على VS2008 و بناء على ذالك عليك أن تقوم ببنائها من داخل الشفرة بشكل التالي :

الرمز PHP:

FileSystemWatcher FileWatcher = new FileSystemWatcher() ; 


و لأن الأداة موجودة داخل فضاء الأسماء IO فعليك استدعاء فضاء الاسماء في بداية الملف , الشفرة :

الرمز PHP:

Using System.IO ; 


المشكلة الأخرى هيا طريقة بناء الأحداث للأدة عن طريق الشفرة , لنفترض أننا نود مراقبة الحدث change ( سأحدث عن لاحقا ) , و الذي يقع في حالة حدوث أية تغيرات على الملفا أو المجلد , الشفرة :

الرمز PHP:

 
FileWatcher .Changed += new FileSystemHandler(Changed_Make); 


الفكرة في الشفرة التي في الاعلى أنني اربط الحدث Changed الخاص بالأداة FileWatcher بالطريقة Changed_Make , هذا الطريقة قد تكون أي شيء ربما ترجع قيمة أو لا تظهر رسالة ..الخ .

بالنسبة لمستخدمي VS2008 , فيمكنك مباشرة إدراج الأداة من شريط الأدوات , التي ستجدها تحت القسم Components .

الطرق و الأحداث و الخصائص .

• أولا الطرق , إذا أمعنت النظر في الصورة الموجودة في الأعلى ستجد أن الأداة لا تحتوي سو على طريقة واحد محملة مرتين , و هيا WaitForChanged , فكرة هذه الطريقة بإختصار مفيد هيا إنتظار حتى ينتهي المستخدم من التعديل على الملف أو المجلد , مثلا لنفترض أنك تقوم بتغير اسم مجلد معين و عندها سيقع الحدث Renamed حتى قبل أن تنهي كتابة اسم المجلد و هنا يأتي دور الطريقة , فجعل الأداة تنتظر قبل تفجير الحدث الملطوب , حتى تحدث فعلا أية تغيرات .

لطريقة صورتين ألاولى أن تجعل الاداة هيا من تحدث متى يتم تفجير الحدث و يتم استدعئها بشكل التالي :

الرمز PHP:

FileWatcher.WaitForChanged(WatcherChangeType.All); 


و هنا تستقبل متغير واحد من النوع التركيب WatcherChange . و الذي يحمل أحد القيمة التالية :

ALL : جميع الأحداث .

Changed : فقط حدث التغير .

Created : في حالة إنشاء ملف جديد .

Deleted : في حالة الحذف .

Renamed : في حالة تغير الأسم .

أما الصورة الثانية لطريقة فهيا تستقبل متغيرن أحدهما WatcherChange و الاخر المدى القصوى التي على الإداة الإنتظار قبل تفجير الحدث و هو من النوع integer , الشفرة :

الرمز PHP:

FileWatcher.WaitForChanged(WatcherChangeType.All,1000); 


• ثانيا الأحداث , بناء على الصورة التي في الأعلى تمنحك الأداة أربعة احداث لا غير و هيا بشكل التالي :

• Changed : عند وقو تغيرات في الملجد (نفس الامر ينطبق على الملفات ) و هنا تكون بشكل عام أي إضافة أو تعديل أو حذف .

• Created : يقع هذا الحدث فقط في حالة إنشاء ملف أو مجلد داخل المسار المراد مراقبته .

• Deleted : و يقع في حالة حذف ملف أو مجلد داخل المسار المراد مراقبته .

• Renamed : و يقع في حالت تغير اسم و لاحظ اسم و ليس مسار , المسار المراد مراقبته .

ثالثا الخصائص : تمتلك الأداة ثمانية ( انضر الصور في الأعلى ) , و هيا بالشكل التالي :

• EnableRaisingEvints : تستقبل هذه الخصية متغير من النوه bool فإذا كانت قيمة المتغير True هذا بعني تمكين الأداة , أما إذا كانت False فهذا يعني إيقاف الأدة .

• Filter : لنفترض أنك تود مراقبة مجلد معين و لكن لا ترغب بمراقبة جميع الملفات , عوضا عن ذالك أن ترغب فقط بمراقبة الملفات النصية , تسمح لك هذه الخاصية بمراقبة نوعية محدد من الملفات و هيا تستقبل من متغير من النوع string يمثل إمتداد الملف .

• IncludeSubdirectories : و هيا تستبقل قيمة من النوع bool فإذا كانت القيمة true ستقوم الأداة بمراقبة جميع محتويات المجلد على اختلاف مستوى العمق , أما إذا كانت flase فيها ستقراب المستوى الأول فقط من المجلد .

• الخاصية Patch : و هنا أنت تحدد مسار الملف \ المجلد المراد مراقبته و هيا تستقبل متغير من النوع string و الذي يمثل المجلد المراد مراقبته .

سأجل بقية المقالة للجزء القادم , اذعرني حدث طرف طارئ ..

[iAGx]

أكمل ما بدأته اليومه في المقالة السابقة , هذا تقريبا كل شي عن أداة FileSystemWatcher , حتى لا أخرج من الموضوع دون طرح مثال , سأقوم بشرح مثال لطريقة مراقبة مجلد و ليكن المفضلة .


مثال لمراقبة مجلد المفضلة .

فكرة المشروع نسخ مجلد المفضلة أو اي مجلد , إلى أي مكان ترغب فيه , كلما قمت بأية تغيرات على المجلد , سواء تعديل أو إضافة أو حذف .. الخ , طبعا هذا بالإعتماد على أداة FileSystemWatcher .

في البداية لابد من تحديد مسار المجلد المراد مراقبته , و من ثم تفعيل اداة FileSystemWatcher و أخير تحديد مستوى المجلدات المراد مراقبتها , و هذا يكون إما في مشيد النموذج أو في حدث التحميل لنموذج , الشفرة :

الرمز PHP:

FileWatcher.Path = Favorites;
FileWatcher.IncludeSubdirectories = true; 


في حالة وجود أية تغيرات , تقوم الأداة بنسخ المجلد الرئيسي و جميع محتوياته إلى مسار أقوم بتحديدة , شفرة النسخ :

الرمز PHP:

 
private bool CopyFolder(string strSrceDir, string strDestDir)
{

DirectoryInfo SourceDir = new DirectoryInfo(strSrceDir);
DirectoryInfo DestDir = new DirectoryInfo(strDestDir);
if (!DestDir.Exists)
DestDir.Create();
foreach (FileInfo ChildFile in SourceDir.GetFiles())
{
ChildFile.CopyTo(Path.Combine(DestDir.FullName, ChildFile.Name), true);
}
foreach (DirectoryInfo SubDir in SourceDir.GetDirectories())
{
if (!SubDir.Exists)
SubDir.Create();
bool retVal;
retVal = CopyFolder(SubDir.FullName, Path.Combine(DestDir.FullName,
SubDir.Name));
if (!retVal)
return false;
}
return true;


} 


كل ما في الأمر الأن انني استدعي هذه شفرة النسخ داخل أحداث الأداة جميعها , بشكل التالي :

الرمز PHP:

//حدث الإنشاء
private void FileWatcher_Created(object sender, FileSystemEventArgs e)
{

CopyFolder(Favorites, FolderTo);
notifyIcon1.ShowBalloonTip(3000, " ",
" .",
ToolTipIcon.Info);
StartStopWatchFile.Enabled = true;
} 


الرمز PHP:

//حدث الحذف
private void FileWatcher_Deleted(object sender, FileSystemEventArgs e)
{
CopyFolder(Favorites, FolderTo);
notifyIcon1.ShowBalloonTip(3000, " ",
" .",
ToolTipIcon.Info);
StartStopWatchFile.Enabled = true;
} 


الرمز PHP:

//حدث إعادة التسمية
private void FileWatcher_Renamed(object sender, RenamedEventArgs e)
{
 
CopyFolder(Favorites, FolderTo);
 
} 


, اعتذر عن الأخطاء الإملائية في الجزء السابق , فقد كنت على عجلة من أمري و لم يتسنى لي مراجعتها ..

المشروع في المرفقات .. تم و الحمد الله