GridAttribute (مرجع واجهة برمجة تطبيقات العميل)

يتم دعم GridAttribute لكل من الشبكات القابلة للقراءة فقط والقابلة للتحرير.

يمثل GridAttribute البيانات الموجودة في خلية شبكة قابلة للتحرير، ويحتوي على مرجع إلى كافة الخلايا المقترنة بالعمود. راجع المجموعات (مرجع واجهة برمجة تطبيقات العميل) للحصول على معلومات حول الطرق المتاحة للوصول إلى البيانات في مجموعة.

يدعم GridAttribute أيضا مجموعة عناصر التحكم لأعمدة صف شبكة محدد، والذي يوفر أساليب للعمل مع مجموعة من الخلايا المقترنة بالعمود. كل خلية (GridCell) لصف شبكة محدد مماثلة لعنصر تحكم في نموذج مرتبط بعمود في شبكة قابلة للتحرير. راجع المجموعات (مرجع واجهة برمجة تطبيقات العميل) للحصول على معلومات حول الطرق المتاحة للوصول إلى البيانات في مجموعة.

تلميح

لأسباب تتعلق بالأداء، لا يمكن تحرير صف (سجل) في شبكة قابلة للتحرير حتى يتم تحديد السجل. يجب على المستخدمين تحديد سجل واحد في شبكة لتحريره. بمجرد تحديد سجل في شبكة قابلة للتحرير، يقيم Dynamics 365 داخليا عددا من الأشياء بما في ذلك وصول المستخدم إلى السجل، وما إذا كان السجل نشطا، والتحقق من صحة العمود لضمان احترام أمان البيانات وصحتها عند تحرير البيانات. ضع في اعتبارك استخدام الحدث OnRecordSelect مع أسلوب getFormContext للوصول إلى السجلات في الشبكة الموجودة في حالة قابلة للتحرير.

أساليب

يدعم GridAttribute الطرق التالية لأعمدة صف شبكة محدد.

Name	الوصف
getName	إرجاع الاسم المنطقي لعمود صف شبكة محدد.
getRequiredLevel	إرجاع قيمة سلسلة تشير إلى ما إذا كانت قيمة العمود مطلوبة أو مستحسنة.
setRequiredLevel	تعيين ما إذا كانت البيانات مطلوبة أو مستحسنة لعمود صف شبكة محدد قبل حفظ السجل.
getValue	استرداد قيمة البيانات لعمود.
setValue	تعيين قيمة البيانات لعمود.

إشعار

لتحديد صف في شبكة قابلة للتحرير، استخدم الشبكة. getSelectedRows

المقالات ذات الصلة

GridCell
الشبكات والشبكات الفرعية في التطبيقات المستندة إلى النموذج
مجموعة عناصر التحكم