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.

Atrybut	Stosowane do	Opis
BrowsableAttribute	Właściwości i zdarzeń	Określa, czy właściwości lub zdarzenia mają być wyświetlane w przeglądarce właściwości.
CategoryAttribute	Właściwości i zdarzeń	Określa nazwę kategorii, w której grupa właściwości lub zdarzenia.W przypadku kategorii właściwości składników i zdarzenia mogą być wyświetlane w logiczne grupowanie w przeglądarce właściwości.
DescriptionAttribute	Właściwości i zdarzeń	Definiuje małych bloku tekstu wyświetlane u dołu przeglądarki właściwości, gdy użytkownik wybierze właściwości lub zdarzenia.
BindableAttribute	Właściwości	Określa, czy właściwość jest interesujące powiązać.
DefaultPropertyAttribute	Właściwości (Wstaw przed deklaracji klasy atrybut).	Określa domyślną właściwość komponentu.Ta właściwość jest zaznaczone w przeglądarce właściwości, gdy użytkownik kliknie formant.
DefaultValueAttribute	Właściwości	Ustawia wartość domyślną proste dla właściwości.
EditorAttribute	Właściwości	Określa edytor do edycji (zmiana) właściwość wizualnego projektanta.
LocalizableAttribute	Właściwości	Określa właściwość może być lokalizowany.Właściwości, które mają atrybut są zachowywane do pliku zasobów automatycznie, gdy użytkownik wybierze do zlokalizowania formularza.
DesignerSerializationVisibilityAttribute	Właściwości	Określa, czy (i jak) właściwości wyświetlanych w przeglądarce właściwości powinny utrwalony kodu.
TypeConverterAttribute	Właściwości	Określa typ konwertera dla konwersji typu właściwości na inny typ danych.
DefaultEventAttribute	Zdarzenia (Wstaw przed deklaracji klasy atrybut).	Określa zdarzenie domyślne dla składnika.To zdarzenie jest zaznaczona w przeglądarce właściwości, gdy użytkownik kliknie składnik.

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