Tasarım zamanı öznitelikleri bileşenleri

Ortak dil çalışma zamanı için meta verileri sağlamak için bkz: nitelikleri uygulama ile alışık değilseniz Öznitelikleri kullanarak meta verileri genişletme.Bileşenleri bir Tasarımcısı'nda aşağıdaki gibi görüntülenebileceğinden Visual Studio, tasarım araçlarına meta verileri sağlayan nitelikleri gereksinim duyarlar.Bu bölümde açıklanmış ve yaygın olarak kullanılan tasarım zamanı öznitelikleri listesini sağlar.

Öznitelikler ve tasarımcı desteği

Görsel tasarım aracı için değerli bilgiler sağladıkları gibi tasarım zamanı öznitelikleri denetimi ve üyelerin doğru tasarım zamanında görüntülemek için gereklidir.

Aşağıdaki kod parçası, CategoryAttribute özniteliği görüntülemek özellik tarayıcısı sağlayan TextAlignment hizalama kategorisinde özelliği.DescriptionAttribute özniteliğini veren özellik Gözatıcısı kullanıcı üzerini tıklattığında özelliğinin kısa bir açıklama sağlayın.

[
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

[!NOT]

De Visual C# ve Visual Basic, adlı bir öznitelik sınıfı ÖznitelikAdıözniteliği, basitçe olarak başvurulabilir ÖznitelikAdı öznitelik sözdizimi.

Bazı tasarım zamanı öznitelikleri sınıf düzeyinde uygulanır.A DesignerAttribute özniteliği sınıf düzeyinde uygulanır ve denetimi görüntülemek için kullanılacak Tasarımcı hangi sınıfı forms tasarýmcýsý bildirir.Bileşenleri varsayılan Tasarımcısı ile ilişkilidir (System.ComponentModel.Design.ComponentDesigner) ve Windows Forms ve ASP.NET sunucu denetimleri, kendi varsayılan tasarımcıları ile ilişkilidir.Uygulama DesignerAttribute bileşen veya denetim için özel bir tasarımcı tanımlarsanız.

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

Sık kullanılan öznitelikler için özellikler ve olaylar

Özellikler ve olaylar için yaygın olarak uygulanan öznitelikleri aşağıdaki tabloda listelenmektedir.

Öznitelik	Uygulanan	Description
BrowsableAttribute	Özellikler ve olaylar	Bir özellik ya da bir olay özellik tarayıcısı içinde görüntülenip görüntülenmeyeceğini belirtir.
CategoryAttribute	Özellikler ve olaylar	' Özelliği veya olayı gruplandırmak istediğiniz kategorinin adını belirtir.Kategoriler kullanıldığında, Bileşen özellikleri ve olayları yerel gruplamaları özellik tarayıcısı içinde görüntülenebilir.
DescriptionAttribute	Özellikler ve olaylar	Küçük bir özelliği veya olayı kullanıcının seçtiği özellik tarayıcısı alt kısmında görüntülenecek metin bloğunu tanımlar.
BindableAttribute	Özellikler	Bağlamak ilginç bir özellik olup olmadığını belirtir.
DefaultPropertyAttribute	Özellikler (Sınıf bildirimi önce bu özniteliği ekleyin.)	Bileşen için varsayılan özellik belirtir.Bu özellik, bir kullanıcı denetimi tıklattığında özellik tarayıcısı içinde seçilir.
DefaultValueAttribute	Özellikler	Basit bir varsayýlan deðerle bir özellik için ayarlar.
EditorAttribute	Özellikler	(Değiştirme) düzenleme için kullanmak üzere Düzenleyicisi'ni belirtir bir özelliği görsel bir tasarımcıdır.
LocalizableAttribute	Özellikler	Bir özellik yerelleştirilmiş belirtir.Bir kullanıcı form yerelleştirmek seçtiğinde bu özniteliğine sahip tüm özellikleri otomatik olarak kaynak dosyasına kalıcı.
DesignerSerializationVisibilityAttribute	Özellikler	(Ve nasıl) koduna özellik tarayıcısı içinde görüntülenen özellik kalıcı belirtir.
TypeConverterAttribute	Özellikler	Özellik türü, başka bir veri türüne dönüştürmek için kullanılacak türü dönüştürücü belirtir.
DefaultEventAttribute	Olaylar (Sınıf bildirimi önce bu özniteliği ekleyin.)	Bileşen için varsayılan olay belirtir.Bu kullanıcı bileşeni tıklattığında özellik tarayıcısı içinde seçilen olaydır.

Aksi belirtilmedikçe, özellikler ve olaylar için öznitelikleri kodundan hemen önce özellik veya olay bildirimi aþaðýdaki örnekte gösterildiði gibi yerleştirilir.

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

Bileşenleri ve denetimleri tasarımcıları ilişkilendirmek tasarım zamanı öznitelikleri hakkında daha fazla bilgi için bkz: Tasarım zamanı desteği genişletme.

Tanımlanan öznitelik sınıflarını kullanarak ek olarak .NET Framework sýnýf kitaplýðý kendi özniteliği sınıflarınızı tanımlayabilirsiniz.Ayrıntılar için programlama dili veya bkz: için belgelerine bakın Özel öznitelikleri yazma.

Ayrıca bkz.

Görevler

Nasıl yapılır: Windows Forms denetimleri öznitelikleri Uygula

Kavramlar

Öznitelikler ve tasarım zamanı desteği

Windows Forms denetimleri öznitelikleri

Diğer Kaynaklar

Tasarım zamanı desteği genişletme