بدء العمل

يحتوي هذا التوثيق على جميع المعلومات التي تبحث عنها بخصوص التعامل مع GCF , إن أول ما ستقوم بالعمل عليه لبناء طبقة التواصل مع قواعد البيانات هو تحديد نص الاتصال بقاعدة البيانات مع ملف الـ web.config او app.config اضف جزء appSetting مف أحد هذين الملفين و من ثم قم بإضافة خاصية DbConnection لها تحتوي على نص الاتصال كـ value

بعدها يمكنك مباشرة العمل مع التصنيف Operations لتواصل مع قاعدة البيانات مثلا يمكنك كتابة جملة بشكل التالي :

تحتوي مكتبة GCF على التصنيفات التالية :

  • Operations

    حيث يتولي هذا التصنيف جميع العمليات التي تتم على قاعدة البيانات و من خلاله يمكنك إنشاء كائنات لتحديث او الاستعلام من قاعدة البيانات .
  • Parameter

    يمكنك من خلال هذا التصنيف تحديد المتغيرات التي يستقبلها اجراء معين في قاعدة البيانات.
    • Name

      اسم الـ Parameter
    • Value

      القيمة الخاص للـ Parameter
    • ParameterDirection

      اتجاه الـ Parameter و قد يكون
      • IN

        اذا كانت اتجاه الـ Parameter Input
      • Out

        اذا كانت اتجاه الـ Parameter Inputout
  • PrimaryKey

    هذا التصنيف مشتق من Attribute و يمكنك استخدامه لتحديد المفتاح الرئيسي في كائن معين.
  • ForeignKey

    هذا التصنيف مشتق من Attribute و يمكنك استخدامه لتحديد المتفاح الاجنبي في تصنيف معين.
  • CommandType

    من خلاله تستطيع تحديد نوع الاجراء الذي ستقوم بتنفيذه حيث يحتمل ان يكون احد الخيارات الثلاثة.
    • StoredProcedure

      اذا جملة الاستعلام عبارة مخزنة في قاعدة البيانات
    • TableDirect

      اذا كان الاستعلام عبارة عن جدول مباشرة
    • Text

      اذا كان الاستعلام عبارة عن جملة استعلام نصية عادية
  • AutoValidation

    هو تصنيف مشتق من Attribute استخدم هذا التصنيف تحديد خصائص التحقق للحقول الخاصة بالكائن حيث يمكنك تحديد التالي :
    • AllowNull

      هل الخاصية يمكن أن تكون Null او لا.
    • ErrorMessage

      رسالة الخطئ التي ستظهر للمستخدم في حالة وقوع الخطئ
    • Expression

      الـ Expression الخاصة بالخاصية يمكنك استخدام هذا الجزء مثلا عند التحقق من البريد الكتروني او اعتماد كملة المرور على شكل معين, عند استخدامك لهذا النوع يجب ان تكون الخاصية Type تساوي Custom
    • Type

      نوع التحقق و قد يكون الانواع التالية
      • Custom

        تحدد عندما ترغب بتحقق من نص بأنه متبع لـ، Expression معين
      • DataBaseExistence

        يمكنك استخدامه مع الكائنات ذات العلاقة مع الكائن الرئيسي حيث سيكون التحقق استعلام في قاعدة البيانات عن كون هذه الكائن موجود في قاعدة البيانات او لا.
      • Number

        اذا كان التحقق رقما
  • DataBaseExistence

    هو تصنيف مشتق من Attribute و يمكنك استخدامه لتحديد الطريقة او الخاصية التي ستستخدم للستعلام عن موجود كائن في قاعدة البيانات او لا

الاستعلام

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

  • الاستعلام و اعادة النتائج على شكل DataTable بدون تمرير متغيرات مع جملة استعلام صريحة
  • الاستعلام و اعادة النتائج على شكل DataTable مع تمرير متغيرات مع جملة استعلام صريحة
  • الاستعلام و اعادة النتائج على شكل DataTable بدون تمرير متغيرات مع Stored Procedure
  • الاستعلام و اعادة النتائج على شكل DataTable مع تمرير متغيرات مع Stored Procedure
  • الاستعلام و اعادة النتائج على شكل كائن بدون تمرير متغيرات مع جملة استعلام صريحة
  • الاستعلام و اعادة النتائج على شكل كائن مع تمرير متغيرات مع جملة استعلام صريحة
  • الاستعلام و اعادة النتائج على شكل كائن بدون تمرير متغيرات مع Stored Procedure
  • الاستعلام و اعادة النتائج على شكل كائن مع تمرير متغيرات مع Stored Procedure
  • الاستعلام و اعادة النتائج على شكل List من كائن بدون تمرير متغيرات مع جملة استعلام صريحة
  • الاستعلام و اعادة النتائج على شكل List من كائن مع تمرير متغيرات مع جملة استعلام صريحة
  • الاستعلام و اعادة النتائج على شكل List من كائن بدون تمرير متغيرات Stored Procedure
  • الاستعلام و اعادة النتائج على شكل List من كائن مع تمرير متغيرات Stored Procedure

العمليات

تستطيع باستخدام GCF تنفيذ عمليات Update , Delete , Insert سواء مع وجود متغيرات Output او لا على حسب الطرق التالية :

  • تنفيذ عملية بدون Data Mapping
  • تنفيذ عملية يدون Data Mapping مع وجود متغيرات Output
  • تنفيذ عملية مع Data Mapping
  • تنفيذ عملية مع Data Mapping مع متغير واحد out من النوع int
  • تستطيع أيضا تنفيذ جملة صريحة مع او بدون Data Mapping

التحقق التلقائي

هذه الميزة تمكنك من إجراء عملية التحقق من الكائن و خصائص بشكل تلقائي لست بحاجة إلى كتابة جمل if المتداخلة مجددا كل ما عليك هو اخبار GCF بخصائص التحقق حيث يمكنك اخبار GCF بتالي :

  • AllowNull

    لاخبار GCF بأن الخاصية يجب أن لا تكون قيمته Null يمكنك تحديد الخاصية AllowNull إلى False
  • Error Message

    لعرض رسالة خاصة على المستخدم عدل الـ Error Message إلى الرسالة التي ترغب
  • Expression

    لتحقق من أن النص المدخل من قبل المستخدم متوافق مع Format معين يمكنك استخدام Expression لهذا العمل

حماية البيانات

لتشفير البيانات من و إلى قاعدة البيانات يجب أن تكون الخاصية AllowEncryption على True و تحديد مفتاح التشغير عن طريق الخاصية EncryptionKey كلاهما في الويب web.config او app.Config أو يمكنك تشفير و فك تشفير حقل محدد في جدول في قاعدة البيانات بشكل يدوي

  • تشفير كل شيء من و إلى قاعدة البيانات

    لعمل ذلك فقط حدد الخاصيتين AllowEncryption و EncryptionKey في ملف app.config او web.config داخل الخاصية appSettings
  • تشفير نص معين مع تمرير مفتاح التشفير

  • تشفير نص معين مع وجود مفتاح التشفير في ملفات الـ Config

  • فك تشفير نص معين مع وجود مفتاح التشفير في ملفات الـ Config

  • فك تشفير نص معين مع تمرير مفتاح التشفير

توليد الشفرة

بالاضافة إلى الإمكانيات الهائلة التي تتمتع بها GCF هناك ميزة أخرى و هيا توليد الشفرة حيث تأتي حزمة التثبيت مع مولد للشفرات الـ Model و الـ Controller على حدا سواء وفقا لمجموعة من الخطوات

  1. تحديد قاعدة البيانات اضغط على على ايقونة قاعدة اليبانات في نافذة الجداول و المشروع ثم اكتب نص الاتصال بقاعدة البيانات في شاشة انص الاتصال ثم اضغط على Save
  2. بعد الاتصال بقاعدة بالبيانات يمكنك مباشرة استعراض قائمة الجداول الموجودة في قاعدة البيانات حيث سيتم سردها في نافذة الجداول و المشروع
  3. لاستعراض شفرتي الـ Model و الكنترول يمكنك الضغط مرتين على اسم الجدول , او الضغط بزر الفائرة الأيمن و من ثم النقر على Show Code او الضفغط على علام ملف C#
  4. لتعديل خصائص الجدول قم بتحديد الجدول من نافذة الجداول و المشرع سيتم بشكل مباشر تحديدة في شاشة الخصائص يمكنك تعديل العديد من الخصائص مثل اسم التنصنيف و الاجراءات المخزنة التي ستستخدمها و خصائص الحقول المختلفة في الجدول من الخلال الخاصية Columns
  5. لتعديل خصائص المشروع و مكان حفظة و اسمه اضغط على ايقونة مشروع C# ستظهر خصائص المشروع
  6. لتوليد الشفرة اضغط على ايقونة توليد الشفرة و يستم توليدها في المكان الذي حددت بشكل تلقائي سيتم توليدها في مجلد C:\Test\