السمات وقت التصميم ل مكونات

If you are not familiar مع applying السمات إلى provide بيانات التعريف إلى the وقت تشغيل اللغة العامة, see Extending بيانات التعريف Using السمات. Because مكونات can be displayed في a مصمم, such كـ Visual Studio, they require السمات that provide بيانات التعريف إلى تصميم-الوقت أدوات. This مقطع describes و provides a قائمة of commonly used تصميم-الوقت السمات.

السمات و مصمم دعم

تصميم-الوقت السمات are essential for displaying your عنصر تحكم و its الأعضاء correctly at تصميم الوقت, كـ they provide valuable معلومات إلى a visual تصميم أداة.

في جزء تعليمات برمجية التالية، تمكن السمة CategoryAttribute مستعرض الخاصية إلى عرض TextAlignmentالخصائص في فئة محاذاة. يسمح السمة DescriptionAttribute مستعرض الخاصية إلى توفير وصف مختصر للخاصية عند قيام مستخدم بالنقر فوق عليه.

[
Category("Alignment"),
Description("Specifies the alignment of text.")
]
public ContentAlignment TextAlignment { //... }

<Category("Alignment"), _
Description("Specifies the alignment of text.")> _
Public Property _
TextAlignment As ContentAlignment
   ' ...
End Property

ملاحظة

في #Visual Cو Visual Basic، سمة فئة المسمى AttributeName سمة يمكن الرجوع إليها من بساطة ك AttributeName في بناء جملة السمة.

يتم تطبيق بعض السمات في وقت التصميم في فئة المستوى. أن سمة DesignerAttribute هو مطبق في المستوى الفئة وقم بإعلام مصمم نماذج أي فئة المصمم لاستخدام عنصر التحكم إلى dهوplay. المكونات المقترنة الافتراضي مصمم ( النظام.ComponentModel.تصميم.Componentتصميمer )، ونماذج Windows ASP.NETعناصر تحكم الملقم تقترن بهم الافتراضي مصممي. قم بيطبق DesignerAttribute فقط إذا قمت بتعريف مصمم مخصصة للمكون الخاص بك أو عنصر تحكم.

// Associates the designer class SimpleControl.Design.SimpleDesigner
// with Simple.
[ Designer(typeof(SimpleControl.Design.SimpleDesigner))]
    public class Simple : WebControl { //... }

' Associates the designer class SimpleControl.Design.SimpleDesigner
' with Simple.
<Designer(GetType(SimpleControl.Design.SimpleDesigner))> _
Public Class Simple
    Inherits WebControl
    ' ...
End Class

سمات عامة ل خصائص والأحداث

يسرد الجدول التالي الالسمات التي يتم تطبيقها بشكل عام إلى الخصائص والأحداث.

السمة	تطبيق إلى	الوصف
BrowsableAttribute	الخصائص والأحداث	تحديد ما إذا كانت خاصية أو حدث ما يجب أن يتم عرضها في مستعرض الخواص.
CategoryAttribute	الخصائص والأحداث	تعين اسم فئة التي إلى المجموعة خاصية أو حدث. عند استخدام فئات، مكوّن خصائص ويمكن عرض الأحداث في مجموعات منطقية في مستعرض الخاصية.
DescriptionAttribute	الخصائص والأحداث	قم بتعريف حظر صغيرة من نص إلى عرضه في botإلىm المستعرض خاصية عند قيام مستخدم بتحديد خاصية أو حدث.
BindableAttribute	Properties	تحديد ما إذا كانت خاصية هو مثيرا للاهتمام اليربط.
DefaultPropertyAttribute	Properties (قم بإدراج هذا سمة قبل إعلان فئة.)	قم بتعيين خاصية الافتراضية مكوّن. Th هو خاصية هو المحددة في المستعرض خاصية عند نقر مستخدم فوق عنصر التحكم.
DefaultValueAttribute	Properties	قم بتعيين القيمة افتراضية بسيطة خاصية.
EditorAttribute	Properties	تعيين المحرر إلى استخدم للتحرير (تغيير) خاصية في مصمم مرئية.
LocalizableAttribute	Properties	تعيين مترجم خاصية. أي الخصائص التي تحتوي على هذه السمة هي auإلىmatically مستمرة في إلى ملفات موارد عندما يختار مستخدم إلى ترجمة نموذج.
DesignerSerializationVisibilityAttribute	Properties	تحديد ما إذا كان (و كيف) يجب أن تكون خاصية في المستعرض الخاصية مستمرة في تعليمات برمجية.
TypeConverterAttribute	Properties	تحدد نوع المحول إلى استخدم لتحويل نوع خاصية إلى نوع بيانات آخر.
DefaultEventAttribute	أحداث (قم بإدراج هذا سمة قبل إعلان فئة.)	تعيين حدث الافتراضي مكوّن. Th هو هو حدث الذي هو المحدد في مستعرض خاصية عند نقر مستخدم فوق مكوّن.

ما لم يرد غير ذلك، يتم وضع السمات للخصائص والأحداث في تعليمات برمجية مباشرة قبل إعلان خاصية أو حدث، كـ هو موضح في المثال التالي.

// To apply CategoryAttribute to the BorderColor 
// property, place it immediately before the declaration
// of the BorderColor property.
[Category("Appearance")] 
public Color BorderColor;

// To apply DescriptionAttribute to the Click event, 
// place it immediately before the declaration
// of the Click event.
[Description("The Click event of the button")]
public event EventHandler Click;

' To apply CategoryAttribute  to the BorderColor 
' property, place it before the property declaration.
<Category("Appearance")> Public BorderColor As Color

' To apply DescriptionAttribute to the Click event, 
' place it before the event declaration.
<Description("The Click event of the button")> Public Event Click

للحصول على المعلومات حول السمات وقت التصميم التي تقترن مصممي مكونات و عناصر التحكم، راجع توسيع دعم وقت التصميم.

بالإضافة إلى استخدام السمة فئة عم المعرفة في .NET Frameworkفئة مكتبة، يمكنك تعريف الخاص بك السمة فئة عم. للحصول على التفاصيل، راجع إلى الوثائق الخاصة بك برمجة لغة أو راجع كتابة سمات مخصصة.

راجع أيضًا:

المهام

كيفية القيام بما يلي: تطبيق السمات في عناصر التحكم Windows Forms

المبادئ

سمات ودعم وقت التصميم

سمات عناصر تحكم Windows Forms

موارد أخرى

توسيع دعم وقت التصميم