Öznitelik Listesi (Visual Basic)

  • Makale

Bildirilen bir programlama öğesine uygulanacak öznitelikleri belirtir. Birden çok öznitelik virgülle ayrılır. Bir özniteliğin söz dizimi aşağıdadır.

Sözdizimi

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Parça

Bölüm Açıklama
attributemodifier Kaynak dosyanın başında uygulanan öznitelikler için gereklidir. Derleme veya Modül olabilir.
attributename Gerekli. Özniteliğin adı.
attributearguments isteğe bağlı. Bu öznitelik için konumsal bağımsız değişkenlerin listesi. Birden çok bağımsız değişken virgülle ayrılır.
attributeinitializer isteğe bağlı. Bu öznitelik için değişken veya özellik başlatıcıların listesi. Birden çok başlatıcı virgülle ayrılır.

Açıklamalar

Neredeyse tüm programlama öğelerine (türler, yordamlar, özellikler vb.) bir veya daha fazla öznitelik uygulayabilirsiniz. Öznitelikler derlemenizin meta verilerinde görünür ve kodunuz için ek açıklama eklemenize veya belirli bir programlama öğesinin nasıl kullanılacağını belirtmenize yardımcı olabilir. Visual Basic ve .NET Framework tarafından tanımlanan öznitelikleri uygulayabilir ve kendi özniteliklerinizi tanımlayabilirsiniz.

Özniteliklerin ne zaman kullanılacağı hakkında daha fazla bilgi için bkz . Özniteliklere genel bakış. Öznitelik adları hakkında bilgi için bkz . Bildirilen Öğe Adları.

Kurallar

  • Yerleşim. Bildirilen programlama öğelerinin çoğuna öznitelik uygulayabilirsiniz. Bir veya daha fazla öznitelik uygulamak için, öğe bildiriminin başına bir öznitelik bloğu yerleştirirsiniz. Öznitelik listesindeki her girdi, uygulamak istediğiniz bir özniteliği ve özniteliğin bu çağrısında kullandığınız değiştiriciyi ve bağımsız değişkenleri belirtir.

  • Açılı Ayraçlar. Öznitelik listesi sağlarsanız, bunu açılı ayraçlara ("<" ve ">") içine almanız gerekir.

  • Bildirimin bir parçası. özniteliği ayrı bir deyim değil, öğe bildiriminin parçası olmalıdır. Bildirim deyimini birden çok kaynak kodu satırına genişletmek için satır devamlılığı sırasını (" _") kullanabilirsiniz.

  • Değiştirici. Kaynak dosyanın başında bir programlama öğesine uygulanan her öznitelikte bir öznitelik değiştiricisi (Assembly veya Module) gereklidir. Kaynak dosyanın başında olmayan öğelere uygulanan özniteliklerde öznitelik değiştiricilere izin verilmez.

  • Bağımsız değişken. Bir özniteliğin tüm konumsal bağımsız değişkenleri herhangi bir değişkenden veya özellik başlatıcıdan önce olmalıdır.

Örnek

Aşağıdaki örnek, özniteliğini bir Function yordamın DllImportAttribute iskelet tanımına uygular.

<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW",
    SetLastError:=True, CharSet:=CharSet.Unicode,
    ExactSpelling:=True,
    CallingConvention:=CallingConvention.StdCall)>
Public Shared Function MoveFile(ByVal src As String,
  ByVal dst As String) As Boolean
    ' This function copies a file from the path src to the path dst.
    ' Leave this function empty. The DLLImport attribute forces calls
    ' to MoveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function

DllImportAttribute , öznitelikli yordamın yönetilmeyen dinamik bağlantı kitaplığındaki (DLL) bir giriş noktasını temsil ettiğini gösterir. özniteliği DLL adını konumsal bağımsız değişken, diğer bilgileri ise değişken başlatıcı olarak sağlar.

Ayrıca bkz.