Dotools

المشروع عبارة عن مكتبة أدوات مساعدة (Dotools) بلغة #C تستهدف .NET Framework 4.7.2، وتوفر مجموعة من الأصناف الثابتة لتسهيل التعامل مع قواعد البيانات باستخدام ADO.NET، بالإضافة إلى أدوات للربط التلقائي بين الكائنات ونتائج قواعد البيانات باستخدام الانعكاس (Reflection)، وتسجيل الأحداث في سجل أحداث ويندوز، وبعض المحولات العامة للبيانات.

أهم المكونات:

• clsStoredProcedureExecutor: صنف ثابت يوفر طرقاً عامة لتنفيذ الإجراءات المخزنة (Stored Procedures) بطريقة موحدة ومرنة. يعتمد على الانعكاس لربط بيانات الكائنات بمدخلات ومخرجات الإجراءات المخزنة تلقائياً. يدعم عمليات القراءة، الإضافة، التحديث، والحذف للكائنات من وإلى قاعدة البيانات.

• clsAdoExecutor: صنف ثابت يدير الاتصال بقاعدة البيانات وينفذ الاستعلامات والإجراءات المخزنة، مع دعم تعبئة الكائنات أو الجداول بالبيانات المسترجعة.

• clsReflectionExecutor: أدوات مساعدة للانعكاس لقراءة وكتابة خصائص الكائنات ديناميكياً، وتستخدم بشكل أساسي في ربط نتائج قواعد البيانات بخصائص الكائنات.

• clsEventLogger: يسجل الرسائل والأخطاء في سجل أحداث ويندوز (Application Log) لدعم تتبع الأخطاء.

• أصناف مساعدة أخرى مثل: clsConverter (لتحويل البيانات والصور)، وclsDataTypes (لأنواع البيانات والفلاتر).

آلية العمل:

• تعتمد المكتبة على مطابقة أسماء خصائص الكائنات مع أسماء معلمات الإجراءات المخزنة (بدون @).

• يتم تسجيل أي خطأ أثناء تنفيذ العمليات في سجل الأحداث.

• تتوقع بعض العمليات وجود معلمة إخراج واحدة (عادةً لإرجاع رقم المعرف الجديد بعد الإضافة).

الاستخدام:

• مناسبة للمشاريع التي تعتمد بشكل كبير على الإجراءات المخزنة وتحتاج إلى ربط ديناميكي بين الكائنات وقاعدة البيانات مع تقليل التكرار البرمجي.

• تسهل عمليات CRUD (إضافة، قراءة، تحديث، حذف) للكائنات المرتبطة بقاعدة البيانات.

إذا كنت بحاجة إلى مثال عملي أو شرح لطريقة الاستخدام، يرجى إعلامي بذلك.