أهم أقسام المدونة

الصفحات

الثلاثاء، 20 ديسمبر 2016

فئة الاتصال DbConnection Class


فئة الاتصال DbConnection Class 

هذه الفئة أساسية مجردة Abstract Base Class (تجب وراثتها MustInherit)، وهي تمثل الواجهة IDbConnection، كما أنها ترث فئة المكون Component Class.. هذه هي صيغة تعريفها:

Public MustInherit Class DbConnection 
           Inherits Component
           Implements IDbConnection, IDisposable

لاحظ أنك لن تستطيع إضافة هذه الفئة إلى صينية مكونات النموذج Component Tray لأنك لا تستطيع إنشاء نسخة جديدة منها، لكن الفئات المشتقة منها مثل SQLConnection يمكن إضافتها إلى صينية المكونات.. لفعل هذا افتح صندوق الأدوات Toolbox، وأسدل الشريط Data، واضغطه بزر الفأرة الأيمن، ومن القائمة الموضعية اضغط Choose Items، وفي النافذة التي ستظهر، ضع علامة الاختيار بجوار مجموعة الأدوات التي تبدأ بالحروف SQL ومن ضمنها SQLConnection، ثم اضغط الزر OK.. الآن ستجد هذه الأدوات تحت الشريط Data في صندوق الأدوات.. انقر الأداة SQLConnection مرتين بالفأرة لإضافة نسخة منها إلى صينية المكونات.

وبالإضافة إلى ما تمثله من خصائص الواجهة IDbConnection، تملك هذه الفئة الخاصيتين التاليتين: 

* مصدر البيانات DataSource:
تعيد اسم خادم سيكويل الذي سيتم الاتصال به.
 

* إصدار الخادم ServerVersion:
تعيد نصا يمثل إصدار سيكويل سيرفر الذي يتصل به العميل.. ويجب أن يكون الاتصال مفتوحا في تلك اللحظة وإلا حدث خطأ. 

وبالإضافة إلى ما تمثله من وسائل الواجهة IDbConnection، تمتلك هذه الفئة الوسيلتين التاليتين: 

 إضافة إلى قائمة التعاملات EnlistTransaction:
أرسل إلى هذه الوسيلة كائن التعاملات Transaction Object الذي تريد ضم تعاملات الاتصال الحالي إليه، لتكوين تعاملات منتشرة Distributed Transaction، وهي تعاملات تنفذ عمليات على أكثر من مصدر وأكثر من اتصال، ولا ينجح تنفيذها إلا إذا نجحت كل أجزائها. 

 معرفة المخطط GetSchema:
تعيد كائن جدول DataTable Object، يحتوي على بيانات المخطط Schema الخاص بالخادم.
ولهذه الوسيلة صيغة ثانية، تستقبل معاملا نصيا يمثل اسم المخطط الذي تريد استعادته.
كما توجد صيغة ثالثة، تزيد على الصيغة السابقة بمعامل ثان، يستقبل مصفوفة نصية String Array، تمثل القيود Restrictions التي تريد الحصول على مخططها. 

كما تمتلك هذه الفئة الحدث التالي: 

  تغير الحالة StateChange:
ينطلق عند تغير حالة الاتصال (عند إغلاقه أو فتحه).. والمعامل الثاني e لهذا الحدث من النوع StateChangeEventArgs، وهو يمتلك الخاصيتين التاليتين: 

OriginalState
تعيد إحدى قيم المرقم ConnectionState التي تمثل حالة الاتصال قبل حدوث التغيير.
CurrentState
تعيد إحدى قيم المرقم ConnectionState التي تمثل حالة الاتصال الحالية (بعد حدوث التغيير).


والفئات التالية ترث الفئة DbConnection:
1- SqlConnection.
2- OdbcConnection .
3- OleDbConnection.
4- OracleConnection.
ما يعني أنها جميعا تمتلك خصائص ووسائل هذه الفئة. 

من كتاب: من الصفر إلى الاحتراف برمجة قواعد البيانات في فيجوال بيزيك دوت نت ADO .NET.. للتنزيل:

ليست هناك تعليقات:

إرسال تعليق

ملحوظة: يمكن لأعضاء المدونة فقط إرسال تعليق.