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

الصفحات

الثلاثاء، 22 يناير 2019

DataTable Class Properties


DataTable Class Properties 

تمتلك فئة الجدول DataTable الخصائص التالية: 
 
اسم الجدول TableName:
تقرأ أو تغير اسم الجدول في مجموعة البيانات. 

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

البادئة Prefix:
تحدد البادئة التي ستميز الجدول كاختصار لاسم نطاقه. 

مجموعة البيانات DataSet:
تعيد كائن مجموعة البيانات DataSet التي ينتمي إليها هذا الجدول.. وتعيد null إذا لم يكن الجدول مضافا إلى مجموعة بيانات حاليا. 

تنسيق التعامل عن بعد RemotingFormat:
تحدد التنسيق الذي سيتم به إرسال بيانات الجدول من جهاز إلى آخر، عندما التعامل مع برنامج يستخدم التحكم عن بعد Remoting، وهي تأخذ إحدى قيمتي المرقم SerializationFormat اللتين تعرفنا عليهما سابقا. 

حساس لحالة الأحرف CaseSensitive:
لو جعلت هذه الخاصيّة true، فستتمّ مراعاة حالة الحروف
(صغيرة Small أو كبيرة Capital) عند مقارنة النصوص في هذا الجدول. 


 المحل Locale:
تقرأ أو تغير كائن معلومات الثقافة CultureInfo، الذي يمثل اللغة التي تريد استخدامها لمقارنة وترتيب النصوص. 

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

الأعمدة Columns:
تعيد مجموعة الأعمدة DataColumnCollection الموجودة في هذا الجدول.. وسنتعرف على هذه المجموعة بالتفصيل لاحقا. 

الصفوف Rows:
تعيد مجموعة الصفوف DataRowCollection الموجودة في هذا الجدول.. وسنتعرف على هذه المجموعة بالتفصيل لاحقا. 

العلاقات الرئيسية ParentRelations:
تعيد نسخة من مجموعة العلاقات DataRelationCollection تحتوي على العلاقات الخارجة من هذا الجدول (العلاقات التي يدخل فيها كجدول رئيسيّ Master Table).. وسنتعرف على الفئة DataRelationCollection بالتفصيل لاحقا. 


العلاقات الفرعية ChildRelations:
تعيد نسخة من مجموعة العلاقات DataRelationCollection، تحتوي على العلاقات القادمة إلى هذا الجدول (العلاقات التي يدخل فيها كجدول فرعي أو جدول التفاصيل Details Table). 

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

القيود Constraints:
تعيد مجموعة القيود ConstraintCollection الموجودة في هذا الجدول.. وسنتعرف على هذه المجموعة بالتفصيل لاحقا. 

العرض الافتراضي DefaultView:
تعيد كائن العرض DataView Object الذي يحمل مبدئيا كل بيانات الجدول الحالي، لكنك تستطيع ضبطه لعرض جزء فقط من سجلات الجدول تبعا لشرط معين.. وسنتعرف على فئة عرض البيانات DataView Class بالتفصيل في الفصل التالي. 

تعبير العرض DisplayExpression:
تقرأ أو تغير النصّ الذي سيتمّ عرضه للمستخدم كعنوان للجدول في أدوات عرض البيانات كالأداة DataGridView. 

به أخطاء HasErrors:
تعيد true إذا كانت هناك أيّة أخطاء في أي صفّ في هذا الجدول. 

الخصائص الإضافية ExtendedProperties:
تعيد مجموعة الخصائص PropertyCollection التي تحتوي على الخصائص الإضافيّة للجدول.. والمثال التالي يضيف خاصيّة اسمها Password إلى جدول الكتب، ويضع فيها القيمة "كلمة المرور"، ثم يغيرها إلى "أحمد123":
DataTable T = Ds.Tables["Books"];
PropertyCollection EP = T.ExtendedProperties;
EP.Add("Password", "كلمة المرور");
EP["Password"] = "أحمد123";
MessageBox.Show(EP["Password"].ToString( ));
 

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

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

إرسال تعليق

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