Bileşenler için Tasarım Zamanı Öznitelikleri
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 |
|---|---|---|
Ö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. |
|
Ö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. |
|
Ö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. |
|
Özellikler |
Bağlamak ilginç bir özellik olup olmadığını belirtir. |
|
Ö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. |
|
Özellikler |
Basit bir varsayýlan deðerle bir özellik için ayarlar. |
|
Özellikler |
(Değiştirme) düzenleme için kullanmak üzere Düzenleyicisi'ni belirtir bir özelliği görsel bir tasarımcıdır. |
|
Ö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ı. |
|
Özellikler |
(Ve nasıl) koduna özellik tarayıcısı içinde görüntülenen özellik kalıcı belirtir. |
|
Ö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. |
|
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 Sunma.
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 Öznitelikler Yazma.
Ayrıca bkz.
Görevler
Nasıl yapılır: Windows Forms Denetiminde Öznitelikleri Uygulama
Kavramlar
Öznitelikler ve Tasarım Zamanı Desteği
Windows Forms Denetimlerindeki Öznitelikler