ca1710: يجب أن يكون لمعرفات لاحقة صحيحة

TypeName	IdentifiersShouldHaveCorrectSuffix
CheckId	ca1710
Category	Microsoft.Naming
تعطيل تغيير	فصل

السبب

لا يحتوي معرّف اللاحقة الصحيحة.

وصف القاعدة

حسب الاصطلاح، أسماء الأنواع التي توسيع بعض الأنواع الأساسيه التي تطبق بعض الواجهات أو الأنواع المشتقة من هذه الأنواع، يكون لديك لاحقة مقترن بالنوع الأساسي أو واجهة.

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

الجدول التالي قوائم الأساس أنواع والواجهات التي قد قمت بإقران اللاحقات.

واجهه/نوع أساسي	لاحقة
System.Attribute	السمة
System.EventArgs	EventArgs
System.Exception	الاستثناء
System.Collections.ICollection	المجموعة
System.Collections.IDictionary	القاموس
System.Collections.IEnumerable	المجموعة
System.Collections.Queue	مجموعة أو قائمة الانتظار
System.Collections.Stack	مجموعة أو مكدس
System.Collections.Generic.ICollection<T>	المجموعة
System.Collections.Generic.IDictionary<TKey, TValue>	القاموس
System.Data.DataSet	DataSet
System.Data.DataTable	مجموعة أو جدول البيانات
System.IO.Stream	الدفق
System.Security.IPermission	الإذن
System.Security.Policy.IMembershipCondition	Condition
تفويض معالج أحداث.	EventHandler

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

أنواع تطبيق ICollection، و عبارة عن مجموعة من عناصر محددة، تحتوي أسماء بكلمة 'مجموعه'. على سبيل المثال، مجموعة من Queueسيضطر الكائنات الاسم 'QueueCollection'. 'مجموعة' تشير إلى اللاحقة التي الأعضاء مجموعة يمكن أن يتم تعداد باستخدام العبارة foreach(For Eachفي Visual أساسى).

نوع s عن تنفيذ IDictionaryالتي تنتهي ب 'قاموس' كلمة if حتى أسماؤها نوع أيضا بتنفيذ IEnumerableأو ICollection. 'مجموعه' و 'قاموس' لاحقة اصطلاحات التسمية التي تسمح للمستخدمين إلى التمييز بين أنماط قائمة تعداد الثاني التالية.

أنواع باستخدام اللاحقة 'مجموعه' اتباع هذا قائمة تعداد نقش:

    foreach(SomeType x in SomeCollection) { }

أنواع مع اللاحقة 'قاموس' اتباع هذا نقش التعداد:

    foreach(SomeType x in SomeDictionary.Values) { }

على DataSetكائن يحتوي على مجموعة من DataTableالكائنات، والتي تتكون من مجموعات من System.Data.DataColumnو System.Data.DataRowالكائنات، وبين الآخرين. ICollectionخلال الأساسية System.Data.InternalDataCollectionBaseفئة. بتطبيق هذه المجموعات

كيف إلى الإصلاح انتهاكات

إعادة تسمية النوع حيث أنه هو suffixed مع المصطلح الصحيح.

عند إلى منع التحذيرات

هو آمن لمنع ظهور رسالة تحذير استخدام اللاحقة 'مجموعه' إذا كان النوع هو بنية بيانات شيوعاً التي قد يتم توسيعها أو الذي سيحتوي على التعيين عشوائية من عناصر متنوعة. في هذه الحالة، اسم الذي يوفر معلومات ذات معنى فيما يتعلق بالتنفيذ أو أداء أي مميزات غير ذلك لبنية بيانات قد معنى (ل مثال، BinaryTree). في الحالات الموقع يمثل النوع مجموعة من نوع معين (ل مثال، StringCollection)، لا تقوم بمنع تحذير من هذه قاعدة لأن اللاحقة تشير إلى تعداد النوع مع foreachالعبارة.

لملحقات غير ذلك، لا بمنع تحذير من هذه قاعدة. يسمح اللاحقة الاستخدام المقصود إلى يبدو من اسم النوع.

القواعد ذات الصلة

Non-constant fields should not be visible Add Existing Items to a Database Project

راجع أيضًا:

المرجع

إرشادات استخدام السمة

المبادئ

أحداث و مفوضون