درس في ADO.NET من الصفر إلى الإحتراف

**sabah** الأربعاء يونيو 15, 2011 6:16 am

بسم الله الرحمن الرحيم
وبه أبدا وأستعين ، وأختم بالصلاة والسلام على خاتم الأنبياء والمرسلين نبينا محمد وعلى آله وصحبه أجمعين ، أما بعد ..
=============

=============
اليوم أقدم لأخواني درس يتناول التعامل مع قواعد البيانات باستخدام ADO.NET من الصفر إلى الاحتراف . والله الموفق ..
=============
وقبل أن أبداء في الدرس أحب أن نغرس في أنفسنا مبدأ يجب أن يتمسك به كل
مسلم وهو حب نشر العلم تقرباً لله تعالى ، وذلك أن العلم أمانه يجب أن تصل
إلى أصحابها وهم اللذين لا يعلمون ، وكل مسلم سوف يسأل عن علمه ماذا عمل به
، وأن نتذكر قول النبي صلى الله عليه وسلم : ( إذا مات ابن آدم انقطع
عمله إلا من ثلاث : صدقة جارية , أو علم ينتفع به من بعده أو ولد صالح يدعو
له ) .
=============
وأحب أن يعرف الجميع أني لست متخصص في البرمجة ، أنا من الهواة وسبقني
الكثير من الأخوان الأفاضل والأكثر مني علماً وخبرة ولذلك سوف استخدم
مجموعة من المراجع والدروس وألخصها وأنقل ما فهمته منها ، ولا تستغربوا إن
وجدتم أخطاء في الدرس هنا أو هناك والمطلوب من وجد معلومة خاطئة أن يصححها و
يوضحها لنا مشكوراً ...
=============
لقد احترت كثيراً في الكيفية التي سوف أبدأ بها كتابة هذا الدرس فانا لست
بارع في هذا المجال ( الكتابة ) ، وهذا الموضوع بالذات كثر فيه الجدل لأنه
متشعب ، ولكي نجعل الموضوع سهل للجميع سوف نأتي بالزبده ( الخلاصة ) ونبتعد
عن التفاصيل المملة التي لا يحتاجها المبتدئ والتي يمكن الرجوع إليها في
الكتب المتخصصة في ذلك .
و قبل كل شيء أحب أن أوضح أنه من المهم أن نتحد في الإصدار الخاص
بـMicrosoft.NET فأنا أستخدم الإصدار 2005 ، وأتعامل مع قواعد البيانات
المصممة بواسطة برنامج Microsoft Office Access 2003 ، ولا أريد أن يغضب
مني أخواني الذين يستخدمون SQL Server ، فانا لم أتعامل معه بشكل مباشر غير
أني قرأت عنه قليلاً ولا أحتاجه في تطبيقاتي حتى الآن . ولكن هذا لا يعني
أن الأخوان الذين يعملون على SQL Server لن يستفيدوا من هذا الدرس لان
إستراتيجية التعامل مع قواعد البيانات في ADO.NET تقريباً موحدة في مختلف
برامج قواعد البيانات سواء المصممة بواسطةMicrosoft Office Access أو SQL
Server أو Oracle ، المهم أن نستخدم سلسلة الاتصال المناسبة ، بالإضافة إلى
فضاء ( مجال ) الأسماء المناسب والكائنات التابعة له ، وكذلك اختيار طريقة
الاتصال المناسبة لاحتياجاتنا ، والتي سوف نتعرف عليها فيما بعد ,,,
=============
تتلخص أهدفنا في التعامل مع قواعد البيانات في النقاط التالية :
1- الاتصال بمصدر قاعدة البيانات .
2- قراءة البيانات التي بها وعرضها بطرق شتى من خلال الأدوات المتوفرة في بيئةMicrosoft.NET .
3- معالجة البيانات وتحديثها من خلال تعديل قيم هذه البيانات أو إضافة بيانات جديدة أو حذف بيانات غير مرغوب فيها .
4- حفظ البيانات المحدثة .
5- الإبحار في البيانات من خلال الانتقال للسجل التالي أو ألعودة للسجل السابق أو الانتقال للسجل الأول أو الانتقال للسجل الأخير .
6- البحث عن البيانات بسهولة ويسر من خلال وضع فلاتر للترشيح .
7- ربط البيانات ذات العلاقة في أكثر من جدول وعرضها ومعالجتها .
8- طباعة التقارير الملخصة للبيانات .
=============
البداية :-
* نبذه عن ADO.NET:
هي مجموعة من الفئات مشمولة في مجال الأسماء System.Data غرضها الوصول إلى
مصادر البياناتData Sources والتي تمثل بيانات محفوظة تحت أنظمة قواعد
بيانات متعددة الأنواع ( مثل Microsoft Office Access أو SQL Server أو
Oracle ) مما يعني قدرتك على الوصول إلى أي قاعدة بيانات مهما كانت الشركة
المنتجة لها . ( أ. تركي العسيري) .
وتقوم ADO.NET باستخدام مزودات البيانات للاتصال بمصادر البيانات ومن ثم
استرجاع هذه البيانات وتعديلها وإعادتها لمصادرها وحفظها هناك ( أ. خالد
الجديع ) .
* الاتصال بقواعد البيانات:-
للوصول إلى البيانات المخزنة في قاعدة البيانات ( والتي سوف تكون في درسنا
هنا عبارة عن ملف من نوع MDB الخاص ببرنامج Microsoft Office Access )
والقراءة منها أو الكتابة فيها يجب أن نكوّن اتصال ناجح معها ، وذلك يتم من
خلال كائن الاتصال المسمى Connection ، ولتجهيز هذا الكائن نحتاج إلى
أعطائه معلومات عن ملف قاعدة البيانات الذي نريد أن نتصل به ( من أهمها على
سبيل المثال مزود البيانات وخادم البيانات واسم ومكان قاعدة البيانات و
كلمة المرور مع كلمة السر إن وجدت ) ، وهذه المعلومات تكوّن لنا بما يسمى
سلسلة الاتصال ( Connection String ) وهي عبارة عن أحد خصائص كائن الاتصال .
* سلسلة الاتصال :
وهي عبارة عن مجموعة من العوامل ( Parameters ) الضرورية للاتصال بقواعد
البيانات ، وتختلف هذه العوامل بناءً على نوع مزود البيانات الذي سوف
نتحدث عنه بالأمثلة في السطور التالية ، ومن أهم ما يهمنا من هذه العوامل
ما يلي :
- Provider : وهو عبارة عن اسم مزود البيانات وسوف نذكر هنا نوعين الأكثر
انتشاراً ، النوع الأول Microsoft.Jet.OLEDB.4.0 وهو للتعامل مع قواعد
بيانات برنامج Microsoft Office Access ، والثاني SQLOLEDB وهو مخصص
للتعامل مع قواعد بيانات برنامج SQL Server .
- DataSource : وهو اسم خادم البيانات ( أللذي يحتوي على جداول البيانات
التي نريد أن نتصل بها ) ، ونجد أن خادم البيانات في برنامج Microsoft
Office Access هو اسم ملف قاعدة البيانات الذي يحمل امتداد MDB ، بينما
برنامج SQL Server فهو عبارة عن اسم الـ Server المثبت على الجهاز .
- Intial Catalog : وهو عبارة عن اسم قاعدة البيانات الموجوده في الخادم بالنسبة لبرنامج SQL Server .
- UserID/Password : وهو عبارة عن اسم المستخدم وكلمة المرور لقاعدة البيانات في حالة وجود قيود أمنية عليها .
ولعل المثالين التاليين تجعل الصورة واضحة جداً :
مثال 1 :
سلسة اتصال بملف قاعدة بيانات برنامج Microsoft Office Access ..

plain text

Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\ MymdbFile.mdb;User ID=Admin;Jet OLEDB:Database Password=You'rePassword;
مثال 2 :
سلسة اتصال بملف قاعدة بيانات برنامج SQL Server ..

plain text

Provider=SQLOLEDB;Data Source=SQL Server DB;Initial Catalog=Northwind;User ID=You'reUserName;Password=You'rePassword
بعد التعرف على سلسلة الاتصال يجب أن نتعرف على نوعيّ طريقة الاتصال بقاعدة البيانات ..
* نوعيّ طريقة الاتصال بقواعد البيانات :
من الجدير بالذكر أننا لو أردنا أن نتصل على قاعدة البيانات بواسطة ADO.NET
يجب أن نختار طريقة الاتصال المناسبة لاحتياجاتنا ، فلدينا طرقتين للاتصال
وهما الاتصال المتصل ( Connection Oriented ) و الاتصال المنفصل (
Connectionless Oriented ) . ولكل منهما امتيازاته وعيوبه و إستراتجياته
الخاصة به في العمل ، غير أن الأخير يعتبر الأمثل في التعامل مع قواعد
البيانات ، وهنا بالتحديد يضيع أغلب من يرغبون تعلم برمجة قواعد البيانات
من خلال ADO.NET .
** هنا ينتهي حديثنا اليوم وذلك لأن المشوار ما زال طويل ولا يمكن استيعابه
في مشاركة واحدة ، ولكي نستوعب هذه الجرعة من المعلومات ونصحح أخطائها إن
وجدت ، ونعلق على الغير مفهوم منها ، و نكمل فيما بعد شرح ما تبقى من الدرس
وذلك في المشاركات القادمة ..
((سبحانك اللهم وبحمدك، أشهد أن لا إله إلا أنت، أستغفرك وأتوب إليك ))

**sabah** الأربعاء يونيو 15, 2011 6:18 am

توقفنا في حديثنا الماضي أن أغلب من يرغبون
تعلم برمجة قواعد البيانات من خلال ADO.NET يضيعون في التفريق بين الاتصال
المتصل (Connection Oriented ) و الاتصال المنفصل ( Connectionless
Oriented ) . والسبب في اعتقادي هو ضعف فهم الآلية التي يعمل بها كل منهما
من ناحية ، والخلط بينهما من ناحية أخرى . ولكي نزيل هذه المشكلة سوف نتحدث
عن كل منهما بشكل مستقل ..
وقبل ذلك يجب أن نوضح أمر مهم وهو : أنه عند بدأ مشروع جديد للاتصال بقاعدة
البيانات يجب قبل كل شيء أن نستدعي فضاء الأسماء المناسب لمزود البيانات
(Provider ) الذي نتعامل معه ، والذي تندرج تحته كائناته الخاصة به للاتصال
بقاعدة البيانات و ومعالجتها ، ومن مميزات استدعاء فضاء الأسماء أنه
يغنينا عن كتابة مسار الكائنات التي سوف نستخدمها ، فقط نكتب اسم الكائن ..

فعند التعامل مع قواعد بيانات Microsoft Office Access نستدعي فضاء الأسماء
System.Data.OleDb وذلك بكتابة الكود التالي في أعلى صفحة الكود :

plain text

Imports System.Data.OleDb
وتندرج تحته مجموعة من الكائنات ولكن كل ما يهمنا منها كمبتدئين ما يلي :
OleDbCommand , OleDbConnection , OleDbDataAdapter , OleDbDataReader ,
OleDbParameter , OleDbCommandBuilder , OleDbTransaction. ,
OleDbException .

وعند التعامل مع قواعد بيانات SQL Server نستدعي فضاء الأسماء System.Data.SqlClient وذلك بكتابة الكود التالي في أعلى صفحة الكود :

plain text

Imports System.Data. SqlClient
وتندرج تحته مجموعة من الكائنات ولكن ما يهمنا منها كمبتدئين ما يلي :
SqlCommand , SqlConnection , SqlDataAdapter , SqlDataReader , SqlParameter , SqlCommandBuilder , SqlTransaction. SqlException .

ملاحظة : الإخوة الذين يستخدمون SQL Server يستطيعون أن يكملوا معنا الدرس
دون مشاكل ، وكل ما عليهم هو أن يستبدلوا عبارة OleDb بعبارة Sql .

* الاتصال المتصل (Connection Oriented ) :

وتتلخص فكرته في أن نقوم بإجراء اتصال مع قاعدة البيانات ، وبعد قبوله
نقوم بفتح الاتصال ثم نقوم بتنفيذ مجموعة من الأوامر التي نحتاجها ( مثل
قراءة البيانات من أجل عرضا للمستخدم ، أو تحديث البيانات من إضافة و
تعديل حذف وحفظ ، أو إلغاء عملية التحديث ، أو البحث عن بيانات معينة أو
ألإبحار والتجول في البيانات ) وبعد الانتهاء نقوم بإغلاق الاتصال ، ويعتبر
إغلاق الاتصال ضرورياً لان معظم مصادر البيانات تدعم عدداً محدوداً من
الاتصالات المفتوحة . وهذا يعني أننا يجب أن نحافظ على الاتصال حتى ننتهي
من الهدف الذي تم من أجله الاتصال .
وهو مناسب " في حاله بناء التطبيقات المفردة ، أي عندما يكون للنظام مستخدم
واحد وتوجد واجه المستخدم ومخزن قاعدة البيانات على نفس الجهاز . " ( أ.
SOLO.NET ، مشرف منتدى ال VB.NET )

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

1- كائن الاتصال OleDbConnection : من أجل الاتصال بقاعدة البيانات .
2- فتح الاتصال بقاعدة البيانات .
3- كائن الأوامر OleDbCommand : في اعتقادي أنه يمثل القلب للاتصال المتصل ،
وهو من أجل تنفيذ عملية قراءة البيانات المخزنة في قاعدة البيانات ، أو
تحديثها ( من إضافة وتعديل وحذف ) ، ويعتمد في تكوينه على وجود اتصال مفتوح
مع قاعدة البيانات ، وعلى جملة الاستعلام البنيوية SQL ( وهي لغة قياسية
لبناء ومعالجة قواعد البيانات ومحتوياتها ، وتتضمن هذه اللغة تعليمات من
أجل إضافة ، تعديل ، حذف ، ترتيب ، و اختيار سجلات ) . ومن أهم خصائصه :-

- Connection : ويجب أن يحمل اسم الاتصال الذي سوف يستخدمه كائن الأمر .

- CommandType : وله ثلاثة قيم ، القيمة Text ( لتنفيذ جملة استعلام
بنيوية SQL ) ، القيمة StoredProcedur ( لتنفيذ إجراء مخزن في قاعدة
البيانات ) ، القيمة TableDairect ( للتعامل مع جدول واحد ) .
ملاحظة : سوف نستخدم في درسنا القيمة Text فقط وهي ما تهمنا كمبتدئين .

- CommandText : ويعتمد على القيمة التي اخترناها في الخاصية السابقة (
CommandType) ، لذلك سوف يكون لدينا ثلاث مدخلات متناسبة معها على التوالي ،
الإدخال الأول عبارة عن جملة استعلام بنيوية والتي سوف يتم تنفيذها سواء
لاختيار أو تحديث السجلات ، المدخل الثاني عبارة عن اسم الإجراء المخزن في
قاعدة البيانات والذي نريد تنفيذه ، والمدخل الثالث عبارة عن اسم الجدول
الذي نريد التعامل معه .

- Parameters : ويستخدم للوصول إلى معاملات الإدخال و الإخراج والقيم العائدة .

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

الطريقة الأولى ( ExecuteReader ) وهي أحد خصائص كائن الأمر وتقوم بتنفيذ
استعلام بنيوي يرجع لنا مجموعة من الصفوف الموجودة في قاعدة البيانات وهو
ما يتطلب استرجاع هذه النتيجة بواسطة الكائن OleDbDataReader والذي سون
نتحدث عنه بعد قليل .

الطريقة الثانية ( ExecuteNonQuery ) وهي أحد خصائص كائن الأمر وتقوم
بتنفيذ استعلام بنيوي يقوم بتحديث قاعدة البيانات ( من إضافة ، تعديل ، و
حذف ) أو تكوين قاعدة بيانات والنتيجة التي ترجع هي عدد الصفوف المتأثرة
بالأمر .

الطريقة الثالثة ( ExecuteScalar ) وهي أحد خصائص كائن الأمر وتقوم بتنفيذ
استعلام بنيوي يرجع لنا قيمة واحده فقط من قاعدة البيانات .

4- كائن قراءة البيانات OleDbDataReader : ويقوم بقراءة تيار من البيانات
القابلة للقراءة فقط وفى اتجاه واحد يكون للأمام فقط . ويعتمد في تكوينه
على وجود كائن أمر مبني على جملة استعلام مصممة لاختيار سجلات . ومن أهم
خصائصه :

- Read : ومهمتها هي توجه قارئ البيانات إلى قراءة الصف الأول من النتائج ، وترجع القيمة True إذا وجد صف أو False إذا لم يوجد صف .

- Item : ومهمتها هي استرجاع قيمة العمود إما باستخدام أسم العمود أو رقمه .

- GetValues : ومهمتها هي استرجاع قيمة الصف كاملاً .

- isDBnull : ومهمتها هي اختبار فيما إذا كانت البيانات تحتوي على قيم Null .

- Close : ومهمته هي إغلاق كائن قارئ البيانات ولا يقوم بإغلاق الاتصال .
مع ملاحظة أنه يجب دائماً إغلاق قارئ البيانات عند الانتهاء منه لان كائن
الأوامر إذا كان يحتوي على معاملات إخراج أو قيم جديدة لن يكون في الإمكان
التعامل معها إلى أن يتم الانتهاء من إغلاق كائن DataReader .

5- إغلاق الاتصال بقاعدة البيانات .

* وهنا نصل للجانب العملي من الدرس :

سوف نركز في الجانب العملي على الثلاثة طرق التي يتم بها العمل في كائن الأوامر OleDbCommand والذي قلنا فيما سبق أنه يمثل القلب .

مثال 1 : الطريقة ExecuteReader ، ماذا لو فرضنا أننا نريد أن نقرأ مجموعة
من البيانات الموجودة في ملف قاعدة البيانات مصمم ببرنامج Microsoft Office
Access والمسمى ( Note ) والذي من المفترض أن يوجد في نفس مسار مشروعنا ،
وهذا الملف محمي بكلمة المرور ( ado.net ) وهو يحتوي على جدول اسمه (
Information ) والذي يحتوي بدوره على الحقول التالية ( ID ويحمل خاصية
الترقيم التلقائي ويعد مفتاح أساسي ، Name ويحمل خاصية كونه نص ، Phone
ويحمل خاصية كونه رقم ) ، ثم نعرض هذه البيانات في مربعات نص ، فكما تعلما
سوف يكون العمل على النحو التالي ...

أولاً : نقوم بفتح مشروع جديد و نضيف مربعات النص التي سوف نعرض فيها قيم الحقول الموجودة في الجدول Information ...

ثانياً : استدعاء فضاء الأسماء الخاص بمزود بيانات برنامج Microsoft Office Access ، وذلك بكتابة الكود التالي في أعلى صفحة الكود ..

plain text

Imports System.Data.OleDb

ثالثاً :
التصريح عن الكائنات التي نحتاجها كمتغيرات في منطقة Declarations في صفحة الكود وذلك كي يتم التعرف علية في مختلف أجزار النموذج
، في البداية نقوم بتهيئة كائن الاتصال وليكن اسمه Conn ، كما في الكود التالي ...

plain text

Dim Conn As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\ ConnectedMode\Note.mdb;User ID=Admin;Jet OLEDB:Database Password=ado.net")
ولكي لا نجعل برنامجنا الذي نتدرب علية مقيد بمسار ثابت وهو " C:\
ConnectedMode\MyNote.mdb " نستطيع أن نجعله أكثر مرونة بحيث يعمل على أي
مسار شرط أن يتواجد ملف قاعدة البيانات والملف التنفيذي للبرنامج في نفس
الموقع ، وذلك من خلال العبارة التالية "|DataDirectory|" بحيث يصبح الكود
السابق كما يلي ..

plain text

Dim Conn As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=|DataDirectory|Note.mdb;User ID=Admin;Jet OLEDB:Database Password=ado.net")
ثم نقوم بالتصريح عن كائن الأوامر وليكن اسمه MyCmd كما في الكود التالي ..

plain text

Dim MyCmd As New OleDbCommand
ثم نقوم بالتصريح عن كائن القراءة وليكن اسمه MyReader كما في الكود التالي ..

plain text

Dim MyReader As OleDbDataReader
رابعاً : في حدث تحميل النموذج نقوم بفتح الاتصال ..

plain text

Conn .Open
خامساً : نقوم بتهيئة كائن الأمر ( باستخدام جملة استعلام بنيوية تقوم
بتحديد حقول معينة من الجدول الموجود في قاعدة البيانات ) كما ذكرنا في
الجزء ألنضري من الدرس ، وذلك من خلال الكود التالي ..

plain text

MyCmd.Connection = Conn
MyCmd.CommandType = CommandType.Text
MyCmd.CommandText = "SELECT ID, Name, Phone FROM Information ORDER BY Name;"
سادساً : نقوم بتهيئة كائن القراءة ، وذلك بإسناد الطريقة ExecuteReader ( التابعة لكائن الأمر MyCmd ) إلية ، كما في الكود ..

plain text

MyReader = MyCmd.ExecuteReader
سابعاً : قبل إسناد قيم الحقول إلى مربعات النص نتحقق من أن كائن القراءة
وجد صفوف تحتوي على بيانات من خلال أداة الشرط IF .. Then .. Else .. End
If وباستخدام الخاصية Read ، وفي حالة توفر البيانات نقوم بإسناد قيمة كل
حقل لمربع النص الخاص به من خلال الخاصية Item ، كما في الكود التالي ..

plain text

If MyReader.Read Then
txtID.Text = MyReader.Item("ID")
txtName.Text = MyReader.Item("Name")
txtPhone.Text = MyReader.Item("Phone")
Else
MsgBox(" Empty ", MsgBoxStyle.Exclamation)
End If
ثامناً : إغلاق كلاً من كائن القراءة وكائن الاتصال ، كما في الكود التالي ...

plain text

MyReader.Close()
Conn.Close()
مثال 2 : الطريقة ExecuteNonQuery ، استنادا للمثال السابق ماذا لو أردنا
تحديث بياناتنا ( إضافة ، تعديل ، و حذف ) ، إذا فلنتابع شرح هذا المثال ..
أولاً : نضيف ثلاثة (Button ) ، ونسمي الأول btnAddNew والثاني btnUpdate والثالث btnDelete .
ثانياً : في حدث النقر لـ btnAddNew نقوم بما يلي ..
1- نقوم بفتح الاتصال ..

plain text

Conn .Open
2- نقوم بتهيئة كائن أمر جديد ونسميه InsertCommand ( باستخدام جملة
استعلام بنيوية تقوم بإضافة بيانات مخزنة في Parameters ( ونرمز لها بالرمز
? ) لحقول معينة من الجدول الموجود في قاعدة البيانات ) كما ذكرنا في
الجزء ألنضري من الدرس ، وذلك من خلال الكود التالي ..

plain text

Dim InsertCommand As New OleDbCommand
InsertCommand.Connection = Conn
InsertCommand.CommandType = CommandType.Text
InsertCommand.CommandText = "INSERT INTO Information(Name,Phone) VALUES(?,?);"
ملاحظة : لم نضيف أي قيمة للحقل ID لأنه له خاصية الترقيم التلقائي .

3- نقم بإعطاء قيم للـ Parameters الموجودة في جملة الاستعلام من خلال
الخاصية Parameters التابعة لكائن الأمر ، وذلك بعد تنظيفه من إي
Parameters ( فيما إذا كانت هناك أي Parameters مستخدمة سابقاً ) ..

plain text

InsertCommand.Parameters.Clear()
InsertCommand.Parameters.AddWithValue("?", txtName.Text)
InsertCommand.Parameters.AddWithValue("?", txtPhone.Text)
4- نطبق الطريقة ExecuteNonQuery والتي سوف تقوم بتنفيذ استعلام تحديث الجدول ..

plain text

InsertCommand.ExecuteNonQuery()
5- نتخلص من كائن الأمر InsertCommand لأننا انتهينا منه وحتى لا يستهلك
جزاء من موارد النظام ، ثم نغلق الاتصال بقاعدة البيانات ونعرض رسالة بنجاح
العملية ..

plain text

InsertCommand.Dispose()
Conn.Close()
MsgBox(" OK ", MsgBoxStyle.Information)
ثالثاً : في حدث النقر لـ btnUpdate نقوم بما يلي ..
1- نقوم بفتح الاتصال ..

plain text

Conn .Open
2- نقوم بتهيئة كائن أمر جديد ونسميه UpdateCommand ( باستخدام جملة
استعلام بنيوية تقوم بتحديث بيانات مخزنة في Parameters ( ونرمز لها بالرمز
? ) لحقول معينة من الجدول الموجود في قاعدة البيانات وذلك اعتمادا على
قيمة الحقل ID كمعرف للسجل الذي نريد تحديثه ) ، وذلك من خلال الكود
التالي ..

plain text

Dim UpdateCommand As New OleDbCommand
UpdateCommand.Connection = Conn
UpdateCommand.CommandType = CommandType.Text
UpdateCommand.CommandText = "UPDATE Information set Name=? , Phone=? WHERE Id =?;"
ملاحظة : لم نقوم بتعديل قيمة الحقل ID لأنه له خاصية الترقيم التلقائي .

3- نقم بإعطاء قيم للـ Parameters الموجودة في جملة الاستعلام من خلال
الخاصية Parameters التابعة لكائن الأمر ، وذلك بعد تنظيفه من إي
Parameters ( فيما إذا كانت هناك أي Parameters مستخدمة سابقاً ) ..

plain text

UpdateCommand.Parameters.Clear()
UpdateCommand.Parameters.AddWithValue("?", txtName.Text)
UpdateCommand.Parameters.AddWithValue("?", txtPhone.Text)
UpdateCommand.Parameters.AddWithValue("?", txtID.Text)
4- نطبق الطريقة ExecuteNonQuery والتي سوف تقوم بتنفيذ استعلام تحديث الجدول ..

plain text

UpdateCommand.ExecuteNonQuery()
5- نتخلص من كائن الأمر UpdateCommand لأننا انتهينا منه وحتى لا يستهلك
جزاء من موارد النظام ، ثم نغلق الاتصال بقاعدة البيانات ونعرض رسالة بنجاح
العملية ..

plain text

UpdateCommand.Dispose()
Conn.Close()
MsgBox(" OK ", MsgBoxStyle.Information)
رابعاً : في حدث النقر لـ btnDelete نقوم بما يلي ..
1- نقوم بفتح الاتصال ..

plain text

Conn .Open
2- نقوم بتهيئة كائن أمر جديد ونسميه DeleteCommand ( باستخدام جملة
استعلام بنيوية تقوم بحذف السجل الحالي من قاعدة البيانات وذلك اعتمادا على
قيمة الحقل ID كمعرف للسجل الذي نريد حذفه والتي سوف نقوم بتخزينها في
Parameter ( ونرمز له بالرمز ? ) ) ، وذلك من خلال الكود التالي ..

plain text

Dim DeleteCommand As New OleDbCommand
DeleteCommand.Connection = Conn
DeleteCommand.CommandType = CommandType.Text
DeleteCommand.CommandText = " DELETE FROM Information WHERE id = ?; "

3- نقم بإعطاء قيمة للـ Parameter الموجود في جملة الاستعلام من خلال
الخاصية Parameters التابعة لكائن الأمر ، وذلك بعد تنظيفه من إي
Parameters ( فيما إذا كانت هناك أي Parameters مستخدمة سابقاً ) ..

plain text

DeleteCommand.Parameters.Clear()
DeleteCommand.Parameters.AddWithValue("?", txtID.Text)
4- نطبق الطريقة ExecuteNonQuery والتي سوف تقوم بتنفيذ استعلام تحديث الجدول ..

plain text

DeleteCommand.ExecuteNonQuery()
5- نتخلص من كائن الأمر DeleteCommand لأننا انتهينا منه وحتى لا يستهلك
جزاء من موارد النظام ، ثم نغلق الاتصال بقاعدة البيانات ونعرض رسالة بنجاح
العملية ..

plain text

DeleteCommand.Dispose()
Conn.Close()
MsgBox(" OK ", MsgBoxStyle.Information)

مثال 3 : الطريقة ExecuteScalar ، استنادا للمثال الأول ماذا لو أردنا
معرفة عدد السجلات المخزنة في الجدول Information ، إذا فلنتابع شرح هذا المثال ..
أولاً : نضيف Button ، ونسميه btnCountId .
ثانياً : في حدث النقر لـ btnCountId نقوم بما يلي ..
1- نقوم بفتح الاتصال بقاعدة البيانات ..

plain text

Conn.Open()
2- نقوم بتهيئة كائن أمر جديد ونسميه CountIdCommand ( باستخدام جملة
استعلام بنيوية تقوم بإعطائنا عدد السجلات المخزنة في الجدول Information )
، وذلك من خلال الكود التالي ..

plain text

Dim CountIdCommand As New OleDbCommand
CountIdCommand.Connection = Conn
CountIdCommand.CommandType = CommandType.Text
CountIdCommand.CommandText = "SELECT Count(id) AS CountID FROM Information;"

3- نقم بالتصريح عن متغير من نوع String ونسميه CountId على سبيل المثال ،
وذلك كي نخزن فيه القيمة التي سوف يعود بها كائن الأمر بعد أن نمرر له
الخاصية ExecuteScalar ..

plain text

Dim CountId As String = CountIdCommand.ExecuteScalar()

4- نقوم بعرض MsgBox يبين لنا القيمة المخزنة في المتغير CountId وهي هنا عدد السجلات الموجودة في الجدول Information ..

plain text

MsgBox(CountId, MsgBoxStyle.Information)
5- نتخلص من كائن الأمر CountIdCommand لأننا انتهينا منه وحتى لا يستهلك
جزاء من موارد النظام ، ثم نغلق الاتصال بقاعدة البيانات ونعرض رسالة بنجاح
العملية ..

plain text

InsertCommand.Dispose()
Conn.Close()
MsgBox(" OK ", MsgBoxStyle.Information)

الكائن الرابع : Transaction ، لم أحب أن ضيفه للكائنات الثلاثة الأولى
لأني أعتقد بأنه فرعي وليس أساسي ، و وضيفته أمنيه بحته ، حيث يستخدم هذا
الكائن غالبا عند عملية تحديث مجموعة سجلات مرتبطة مع بعضها دفعة واحدة ،
فإذا فشل في تحديث أحدهم يتم إلغاء العملية بالكامل ، على سبيل المثال : في
الحسابات البنكية ، عند سحب مبلغ من حساب أحد الأشخاص و إيداعه في حساب
شخص أخر ، فثل هذه العملية يجب أن تحدث دفعة واحده ، ولو حدث أي مشكله فنية
في العملية يجب إلغاء هذه العملية بالكامل .
ومن أهم خصائص الكائن Transaction هي الخصيتان (Commit و Rollback ) .
حيث أن الخاصية Commit تدل على نجاع العملية بدون مشاكل أو أي أخطاء وتسمح
بتحديث البيانات ، و في حاله عدم تحقق شرط معين أو حدوث خطأ فإن الخاصية
Rollback تقوم بعمل تراجع وتلغي العملية .
ولكي نهيئ الكائن Transaction يجب أن نصرح عنه كمتغير كما في الكود ...

plain text

Dim MyTransaction As OleDbTransaction
ثم نستدعي الخاصية BeginTransaction التابعة لكائن الاتصال ونسندها له ، كما يلي ..

plain text

MyTransaction = Conn.BeginTransaction
، ثم نهيئ كائن الأمر ( على سبيل المثال InsertCommand ) الذي نريد منه
تحديث البيانات بإضافة سجل جديد ، وذلك باستدعاء الخاصية Transaction
التابعة له وإسناد الكائن Transaction له ..

plain text

InsertCommand.Transaction = MyTransaction
وبعد تنفيذ الخاصية ExecuteNonQuery لكائن الأمر نقوم بإستدعاء الخاصية
Commit التابعة للكائن Transaction وذلك لتأكيد قبول العملية ونجاحها ..

plain text

MyTransaction.Commit()
وفي حالة وجود أي مشكلة نستدعي الخاصية Rollback التابعة للكائن Transaction وذلك للقيام بإلغاء العملية ...

plain text

MyTransaction.Rollback ()
لذلك ننصح تعشيش كل العمليات التي يتوقع وجود مشاكل بها داخل دالة اكتشاف الأخطاء Try...Catch…Finally .

المثال الرابع : الكائن Transaction ، بالرجوع للمثال الثاني ونريد تعديل
بيانات السجل الحالي ونريد أن نستخدم الكائن Transaction كي نضمن عدم حدوث
أخطاء وأن كل البيانات المطلوبة قد تم تحديثها ، والتراجع عن التحديث
بالكامل في حالة لم يتم تحديث حقل من الحقول . وللقيام بذلك نتبع الأتي ..
في حدث النقر لـ btnUpdate نقوم بما يلي ..
1- نقوم بالتصريح عن متغيرين ، الأول كائن Transaction ونعطيه الاسم
MyTransaction ، والثاني Command ونعطيه الاسم UpdateCommand ...

plain text

Dim MyTransaction As OleDbTransaction
Dim UpdateCommand As New OleDbCommand
2- نقوم بتعشيش دالة اكتشاف الأخطاء Try...Catch…Finally ( مع ملاحظة أننا
في جزئية الدالة Catch قمنا بالتصريح عن متغير أسميناه Filed من نوع
OleDbException وهو من الكائنات التابعة لفضاء الأسماء System.Data.OleDb
ونستفيد منه في الحصول على معلومات عن سبب الخطأ عند حدوثه في مصدر
البيانات . ) كما يلي ..

plain text

Try
' العمليات التي نرغب في اصطياد أخطائها إن وجدت
Catch Filed As OleDbException
' الأخطاء التي تم اصطيادها ، بالإضافة للتصحيح المناسب لها
Finally
' العمليات التي يجب تنفيذها على كل حال
End Try

ملاحظة : في الجزء الذي يحتوي على العمليات التي نرغب في اصطياد أخطائها إن وجدت من دالة Try نقوم بما يلي ..

3- نقوم بفتح الاتصال ..

plain text

Conn .Open
4- استنادا لما تعلمناه في السطور السابقة نقوم بإعداد وتجهيز كلاً من
الكائن Transaction والكائن Command ( مع ملاحظة أننا استخدمنا هذه المرة
الخاصية ExecuteNonQuery لتحديث الحقل Name لوحده ثم استخدمناها مرةً أخرى
لتحديث الحقل Phone ، مع تعمد كتابة خطأ في جملة الاستعلام التي نحدث بها
الحقل Phone وبالتحديد في الكلمة "UPDATE" والتي كتبناها ABDATE"" ، وذلك
حتى نتعرف على الطريقة التي سوف يتم بها اصطياد الخطأ وكيف سوف يتم تصحيحه )
...

plain text

MyTransaction = Conn.BeginTransaction
UpdateCommand.Connection = Conn
UpdateCommand.Transaction = MyTransaction
UpdateCommand.CommandType = CommandType.Text
UpdateCommand.CommandText = "UPDATE Information set Name=? WHERE Id =?;"
UpdateCommand.Parameters.Clear()
UpdateCommand.Parameters.AddWithValue("?", txtName.Text)
UpdateCommand.Parameters.AddWithValue("?", txtID.Text)
UpdateCommand.ExecuteNonQuery()
UpdateCommand.CommandText = "ABDATE Information set Phone=? WHERE Id =?;"
UpdateCommand.Parameters.Clear()
UpdateCommand.Parameters.AddWithValue("?", txtPhone.Text)
UpdateCommand.Parameters.AddWithValue("?", txtID.Text)
UpdateCommand.ExecuteNonQuery()
5- نقوم باستدعاء الخاصية Commit التابعة للكائن Transaction وذلك لتأكيد قبول العملية ونجاحها مع عرض رسالة تفيد بنجاح العملية ..

plain text

MyTransaction.Commit()
MsgBox(" OK ", MsgBoxStyle.Information)

ملاحظة : في الجزء المسمى Catch من دالة Try والذي يحتوي على الأخطاء التي
تم اصطيادها ، بالإضافة للتصحيح المناسب لها نقوم بما يلي ..
6- نستدعي الخاصية Rollback التابعة للكائن Transaction وذلك للقيام بإلغاء
العملية ، ثم نعرض رسالة نصية توضح لنا معلومات عن الخطأ الذي وقع أثناء
تنفيذ البرنامج ...

plain text

MyTransaction.Rollback()
MsgBox(Filed.Message, MsgBoxStyle.Exclamation)
ملاحظة : في الجزء المسمى Finally من دالة Try والذي يحتوي على العمليات التي يجب تنفيذها على كل حال ، نقوم بما يلي ..
7- نتخلص من كائن الأمر UpdateCommand لأننا انتهينا منه وحتى لا يستهلك جزاء من موارد النظام ، ثم نغلق الاتصال بقاعدة البيانات ..

plain text

UpdateCommand.Dispose()
Conn.Close()

درس في ADO.NET من الصفر إلى الإحتراف

درس في ADO.NET من الصفر إلى الإحتراف

رد: درس في ADO.NET من الصفر إلى الإحتراف