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

الكود التالي يقوم بتمرير باراميتر يحمل الاسم ProductName@ الى الاستعلام الموجود في الكائن cmd :

اذا جربت ادخال اي من القيم التاليه في TextBox1 فسيعمل الكود بلا مشاكل ولن تحدث اي اخطاء بمشيئه الله :

الآن سنشرح الكود حبه حبه :
1- في السطر الأول تم انشاء متغير نصي جديد واسندنا له جمله الاستعلام المطلوبة واهم ما فعلناه هو اننا وضعنا بدلا من قيمه الحقل ProductName القيمه ProductName@ والتي تمثل اسم الباراميتر الذي سنمرره للكائن Parameter .
2- في السطر الثاني انشأنا كائن جديد من النوع SQLCommand ولك حريه نوعه على حسب قاعدة البيانات فيمكن ان يكون OleCommand او OracleCommand على حسب نوع قاعدة البيانات .
3- في السطر الثالث قمنا بإضافه باراميتر جديد الى مصفوفة الباراميترات التي تتبع الكائن cmd ، وهنا استخدمنا طريقة مباشره لتعريف الباراميترات وهي اننا اضفناه عن طريق الطريقة AddWithValue ومررنا له القيم المطلوبه .
المهم في السطر الثالث هنا هوه اننا وضعنا اسم الباراميتر المراد ارسال قيمته وهي ProductName@ ووضعنا القيمه الخاصه به وهي النص الموجود في الخاصيه Text التابعه للكائن textBox1 .
الباراميترات داخل جمل الاستعلام SQL :
وبالنسبه لتسميه المتغيرات في جمل الاستعلام SQL يمكنك ان تضع اي اسم تشاء ، ابعد عن الاسماء العربية ، لا تستخدم الارقام ، ولا تضع الاسم بين حاصرتين ولا مسافات . ويفضل لو يبدأ بالرمز @ لتسهل على نفسك قراءه الكود لاحقا ولتعرف مباشره ان تلك الكلمه هي اسم لباراميتر بمجرد وجود @
تسميه الباراميتر تتيح لنا تمرير واستلام قيم اكثر من باراميتر واحد ، فيمكنك انشاء عدد من الباراميترات وكل منها له اسم معين وعند اضافتها الى المصفوفة Parameters ستقوم بارسال كل قيمه مع اسم الباراميتر فتتجنب اي مشكله بخصوص الباراميترات ،
بعض المبرمجين قد يضع العلامة ? بدلا من قيمه كل حقل ويستخدمها مع كل الحقول ، وبالتالي سيكون لكل الباراميترات الاسم نفسه ، في هذه الحاله يجب ان تضيف كل باراميتر وقيمته الى مصفوفة الباراميترات Parameters التابعه للكائن cmd بالترتيب، مع ذلك ، انا لا احبذ هذه الطريقة مطلقا .
الكائن Parameter :
حتى يكتمل حديثنا عن البارميترات ، احببت ان تكلم عن الكائن Parameter .
يمكننا انشاء باراميتر جديد بالصيغه التالية :

طبعا الكود السابق هو مثال لكيفية انشاء باراميتر جديد خاص بـ SQL او باكسس . الغرض منه ان تعرف ان الكائن Parameter يتبع احد انواع مزودات قواعد البيانات في ADO.NET .

في الكود التالي قمنا بتعريف باراميتر بالإسم ProductNameParameter واسناد قيمه ونوع له :

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

• ParameterName : وهي خاصيه من النوع String ويجب ان تسند لها اسم الباراميتر الذي وضعته في جمله الاستعلام .
• SqlDBType : وهي خاصيه تقوم بتحديد نوع قيمه البارميتر من خلالها ، وهي تختلف باختلاف نوع مزود قاعدة البيانات للباراميتر ، فلو كانت SQL كحالتنا هذه ستكون SQLDBType ولو كانت تتبع OleDB ستكون OleDBType وهكذا .
• Value : وهذه الخاصيه تمثل قيمه الباراميتر .

لمن يريد التوسع حول الانواع الممكنه للباراميترات والتي نسندها للخاصيه Type يمكن زياره الرابط التالي في حاله OleDB او الرابط التالي في حاله SQL .

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

كود أخير اضيفه في هذا الجزء لمن يرغب بإرشاد لمعرفه كيفيه انشاء اكثر من باراميتر واحد والتعامل معها :

السلام عليكم ورحمه الله وبركاته
سنتكلم اليوم عن موضوع مهم في قواعد البيانات والتعامل معها … سنتكلم عن الكائن Parameters التابع لأي فئة Command في اي فئة تتبع فضاء الأسماء Data سواء كانت OleDB او SQL او Oracle … او غيرها من من الفئات والكائنات .
مقدمة :
في أي تطبيق يعتمد على قواعد البيانات ، تبرز أهميه ارسال الباراميترات Parameters الى قاعدة البيانات ، وغالبا ما يتم ذلك عن طريق جمل الإستعلام SQL Statements حتى وقت كتابة هذه المقالة ( قريبا سنستخدم Linqمع VS2008 ) ومنهم من يفضل حفظ الاستعلاما في قاعدة البيانات والاكتفاء بمخاطبتها وارسال الباراميترات اليها واستقبال نواتجها على التطبيق .

نستخدم الباراميترات في اغلب الحالات لعميات مختلفه ، كالبحث ، والمعايره من الجداول والاستعلامات الموجوده ، فمثلا الكود التالي يقوم بالبحث في الجدول Products واظهار الحقول ProductID و ProductName بشرط ان تكون الـ ProductName تبدأ بقيمه نصيه معينه يحددها المستخدم بكتابتها في مربع النص TextBox1 :

ليس البحث وحده كما ذكرنا ، بل ايضا اضافه وحذف البيانات وتعديلها من قاعد البيانات خصوصا في الوضع المنفصل Disconnected Mode ، لذلك فهي جزء اساسي من تطبيقات قواعد البيانات والتطبيقات الاخرى المسانده لها .
الكائن Parameter :
تقدم لك ADO.NET الكائن Parameter التابع لأي كائن أمر Connection ، هذا الكائن وظيفته ارسال البيانات الى قواعد البيانات في الاستعلامات ، سواء تلك الاستعلامات المكتوبه في تطبيقك مباشره بوساطه جمله استعلام SQL او الاستعلامات المحفوظه في قاعدة البيانات ذاتها .
ويمكن استخدام الكائن Parameter في الكود اعلاه ليكون بالشكل التالي :

حيث يتم اتباع الخطوات التالية عندما نرغب باستخدام الكائن Parameter :
1- في جملة الاستعلام ، نقوم بوضع تسميه معينه بدلا من اسناد قيمه متغير او كائن الى حقل معين ، فلو تلاحظ في الكود الماضي تم استخدام ProductName@ بدلا من وضع علامات تنصيص ثم استخدام الاداة TextBox1
2- تمت اضافه عنصر جديد الى مصفوفة الباراميترات التابعه للكائن cmd والذي هو عباره ع كائن اوامر SqlCommand مع مراعاة استخدام نفس تسميه الباراميتر التي وضعناها في جملة الاستعلام SQL او حتى تلك المحفوظة في استعلام قاعدة البيانات ونعطيه القيمه المطلوبة وهي النص المكتوب في TextBox1 .
احدى فوائد الباراميترات هي المحافظه على شكل جمله الاستعلام من وضع علامات الاقتباسواسماء كائنات مربعات النصوص او الادوات التي تحتوي على القيمه المطلوب ارساله مع جمله الاستعلام ، فائده اخرى نجنيها ، وهي امكانيه استخدام الاستعلامات المخزنة في قاعدة البيانات التي تتطلب باراميترات ، فنحن في تطبيقاتنا نرغب بأن يتم عرض البيانات على شرط يحدده المستخدم وليس شرطا ان تكون قيمه ثابته في كل مره خصوصا عند البحث والاضافه والحذف والتعديل .
فوائد اخرى سنعرفها في السطور التاليه وهي مهمه جدا .
بالعودة الى الكود الذي وضعناه في البدايه :

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

Chef Anton’s

الآن جرب الكود وانظر الى الخطأ الذي سيحدث وكله بسبب استخدام العلامه الصغيره ‘ ، طيب اذا كان المستخدم يدخل البيانات باللغه الانجليزية فان من حقه استخدام تلك العلامة في كتابه الاسماء وغيرها ، حتى في اللغه العربيه قد نحتاجها احيانا ،
طيب ما الحل ؟ الحل استخدم الباراميترات Parameters باستخدام الكائن Parameter .
حالة ثانيه وهي عند الرغبه في ادخال تاريخ مثل الاستعلامات التالية :

لكوننا نستخدم النظام التالي في ادخال التواريخ : dd/MM/yyyy وليس النظام الأمريكي MM/dd/yyyy فإن احتمال ظهور رسائل الخطأ وارد جدا ، وعمليه استخدام الداله Format لتغيير التنسيق اعتبره شخصيا انتقاص من حقنا من قبل الأمريكان بإجبارهم لنا ان نستخدم طرق ملتويه وان كانت سهله لمجرد اننا لا نتبع نظام تاريخهم في التنسيق .
طيب ما الحل ؟ الحل استخدم الباراميترات Parameters باستخدام الكائن Parameter .
حالة ثالثه ، جرب استخدام الاستعلام التالي :

الآن يسرني ان اخبرك بأنه من عاشر المستحيلات ان تستخدم الكود السابق لادخال قيمه في الاستعلام مثل التالية :

x’

والسبب ببساطه انه سيكون لديك استعلام بالشكل التالي :

ونحن معلوم لدينا انه لا يمكن ان نستخدم الحاصره ‘ من دون اغلاقها بواحده اخرى تليها !
ايضا استخدام الادخال التالي يؤدي الى خطأ آخر مشابه :

x’ –

طيب ما الحل ؟ الحل استخدم الباراميترات Parameters باستخدام الكائن Parameter .
كيف نستخدم الباراميترات في جميع الحالات السابقه ؟ هذا ما سنعرفه في الجزء الثاني ،

عمل تقرير لعرض سجل معين

لاحظت كثرة الأسئلة حول كيفية عمل تقرير لسجل واحد فقط ، وللأسف فإن اغلب السائلين لا يحددون نوع التقارير المستخدم ، وايضا هذا السؤال يتكرر بكثرة ، فقمت بعمل مثال مبسط حول حل هذا السؤال بواسطة اداة التقارير الخاصة بفيجوال ستوديو Microsoft Reporting Tool بواسطة الاصدار 2008 وهي لا تختلف كثيرا عن 2005 لكن لايوجد لدي الاصدار 2005 ، مع ذلك سأقوم بشرح الطريقة فلا تقلقوا

فكرة الحل :

يكمن الحل في عمل filter لبيانات التقرير بإستخدام حقل مميز للسجلات – في مثالي استخدمت قاعدة البيانات الشهيرة Northwind والجدول Customers تحديدا ، في ذلك الجدول ، الحقل Id هو المميز والذي لا يتكرر في كل الظروف – لذلك سنقوم بعمل Parameter ونضعه في الـ filter الخاص بالتقرير ، ثم نمرر قيمته بواسطة الكود قبل عرض التقرير على النافذة .

الحل :
نقوم بعمل مشروع جديد ونضيف له مصدر بيانات جديد New Data Source ثم نحدد قاعدة البيانات Northwind بعدها نختار الجدول customers فقط ونقوم بتسمية الـ Dataset بأي إسم نرغبه ، وليكن CustomersDataset ثم ننهي المعالج بالطبع .

بعدها نقوم بإضافة تقرير جديد الى المشروع وذلك من خلال الضغط على Ctrl+shift+A ثم اختيار Report بعدها سيفتح لنا مصمم التقارير بالتقرير الجديد .

بداية نذهب الى القائمة Report ونختار الأمر Data Sources ومن هناك نقوم بإضافة الـ Dataset الذي قمنا بإضافته توا للمشروع ثم نغلق مربع الحوار .

بعدها تأتي الخطوة الاهم على الإطلاق ،نذهب الى القائمة Report مجددا ونختار Report Parameters لتظهر لنا النافذة التالية :

نقوم بإضافة Parameter جديد ونحدد نوع ليكون Integer ثم نكتب إسمه وليكن CustomerID ثم نضغط على زر OK .

الآن نقوم بإضافة اداة Table وعليها الحقول المطلوبة ( لا اشرح هذه العملية هنا !! ) ثم نقوم بالضغط بالزر الأيمن على ال table في الزاوية العلوية اليسرى بعدها نختار Properties ، ومن النافذة الظاهره نختار Filter ثم هناك بإضافة filter جديد للـ grid ونختار الـ Operator الخاص بالمساواة ، ومن العمود Value نختار من القائمة المنسدلة Expression ومن نافذة ال Expression Editor نختار Parameters وسنرى هناك الباراميتر الذي قمنا بإضافته سابقا ، سنقوم الآن بالضغط على نقرا مزدوجا ثم نضغط على زر OK ونغلق النافذة .

الآن نذهب الى النافذة التي ستعرض التقرير ونضيف في البداية شريط ادوات ToolStrip وبه ثلاث أدوات بالترتيب :
- Label : نكتب عليه نص توجيهي للمستخدم وليكن filter Customer ID ،
- TextBox : اسمه tstxtCustomerID
- Button : اسمه tsbtnshowReport وليكن بالنص فقط ونصه Show Report .

الآن نقوم بوضع اداة Microsoft Report Viewer على النافذة ومن Choose Reports نختار التقرير الذي اضفناه سابقا .

ثم نذهب الى محرر الاكواد الخاص بالنافذة ونضيف فضاء الأسماء التالي :

ثم نقوم بحذف السطر :

من الحدث Load الخاص بالنافذة form .

بعدها نقوم بكتابة كود للزر tsbbtnShowReport في حدث النقر Click ونكتب الكود التالي :

شرح الكود :
في السطر الاول قمنا بإنشاء مصفوفة من النوع ReportParameter ونختار العنصر الأول فيها ( رقم صفر ) ليكون كائنا جديدا من النوع ReportParameter، وبإستخدام المشيد Constuctor نعطه الوسائط Arguments المطلوبة كما يلي :
- ParameterName : وهنا نكتب اسم الباراميتر الذي اضفناه في التقرير سابقا .
- Value : وهنا قيمة التقرير ، وهي قيمة الشرط في الـ filter ،

ثم نقوم بإضافة الباراميترات الى التقرير من خلال السطر :

بعدها نقوم بإظهار محتويات التقرير بالسطر:

لذلك قمت بحذفه من الحدث Load لأننا لا نريد عرض التقرير بذلك الشكل، وخذها كمعلومة ، التقرير الذي يحتوي على باراميترات لم تعط قيما لها لن يظهر بل سيطبع رسالة الخطا على جسم التقرير !!

اخيرا الفكرة المستخدمه هنا بالباراميترات يمكن استخدامها لعرض البيانات بين مجالين او تجميع او اي شيء تحتاجه تضع مكانه اسم الباراميتر بإستخدام الـ Expression Editor وتجعل تقاريرك ديناميكية اكثر .

لتحميل المثال المذكور يرجى النقر هنا