Atrybuty czasu projektowania dotyczące składników

Jeśli nie zna stosowanie atrybutów dostarczyła metadanych do plików wykonywalnych języka wspólnego, zobacz Rozszerzanie atrybuty metadanych za pomocą.Ponieważ składniki mogą być wyświetlane w projektancie, takich jak Visual Studio, wymagają one atrybuty, które zapewniają metadanych w czasie projektowania narzędzia.W tej sekcji opisano i zawiera listę najczęściej używanych atrybutów w czasie projektowania.

Atrybuty i wsparcie Designer

Atrybuty projektowania są istotne dla poprawne wyświetlanie formantu i jego członków w czasie projektowania świadczą one wizualnym narzędziem cenne informacje.

W następujący fragment kodu CategoryAttribute atrybutu umożliwia przeglądarce właściwości wyświetlić TextAlignment właściwości w kategorii wyrównania.DescriptionAttribute atrybut zezwala przeglądarce właściwości podać krótki opis właściwości, gdy użytkownik go kliknie.

[
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

[!UWAGA]

W Visual C# i Visual Basic, klasą atrybutu o nazwie Nazwa_atrybutumożna odwoływać się po prostu jako atrybut Nazwa_atrybutu w składni atrybutu.

Niektóre atrybuty projektowania są stosowane na poziomie klasy.A DesignerAttribute atrybut jest stosowany na poziomie klasy i informuje projektanta formularzy, które Projektant klasy służy do wyświetlania formantu.Składniki są skojarzone z projektantem domyślnej (System.ComponentModel.Design.ComponentDesigner) i Windows Forms i ASP.NET formanty serwera są skojarzone z własnych projektanci domyślne.Zastosowanie DesignerAttribute tylko wtedy, gdy zdefiniować niestandardowe Projektant składnika lub formantu.

// 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

Wspólne atrybuty właściwości i zdarzeń

Poniższa tabela zawiera listę atrybutów, które są powszechnie stosowane do właściwości i zdarzenia.

Chyba że ustalono inaczej, atrybuty właściwości i zdarzeń są umieszczane w kod bezpośrednio przed deklaracji właściwości lub zdarzenia, jak pokazano w następującym przykładzie.

// 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

Informacji dotyczących projektowania atrybutów, które skojarzyć projektanci składników i formantów, zobacz Rozszerzona pomoc techniczna czasu projektowania.

Korzystając z klasy atrybutów zdefiniowane w .NET Framework Biblioteka klas można definiować własne klasy atrybutu.Szczegóły można znaleźć w dokumentacji języka programowania lub zobacz Wpisywanie atrybutów niestandardowych.

Zobacz też

Zadania

Porady: stosowanie atrybutów w formantach formularzy systemu Windows

Koncepcje

Atrybuty i pomoc techniczna podczas projektowania

Atrybuty w formantach formularzy systemu Windows

Inne zasoby

Rozszerzona pomoc techniczna czasu projektowania