Daftar Atribut (Visual Basic)

  • Artikel

Menentukan atribut yang akan diterapkan ke elemen pemrograman yang dinyatakan. Beberapa atribut dipisahkan dengan koma. Berikut ini adalah sintaks untuk satu atribut.

Sintaks

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Generator

Bagian Deskripsi
attributemodifier Wajib ditulis untuk atribut yang diterapkan di awal file sumber. Dapat berupa Rakitan atau Modul.
attributename Harus diisi. Nama atribut.
attributearguments Opsional. Daftar argumen posisi untuk atribut ini. Beberapa argumen dipisahkan oleh koma.
attributeinitializer Opsional. Daftar penginisialisasi variabel atau properti untuk atribut ini. Beberapa penginisialisasi dipisahkan oleh koma.

Keterangan

Anda dapat menerapkan satu atau lebih atribut ke hampir semua elemen pemrograman (jenis, prosedur, properti, dan sebagainya). Atribut muncul di metadata rakitan Anda, dan dapat membantu Anda membuat anotasi kode atau menentukan cara menggunakan elemen pemrograman tertentu. Anda dapat menerapkan atribut yang ditentukan oleh Visual Basic dan .NET Framework, dan Anda dapat menentukan atribut Anda sendiri.

Untuk informasi selengkapnya tentang kapan harus menggunakan atribut, lihat Gambaran umum atribut. Untuk informasi tentang nama yang valid, lihat Nama Elemen yang Dinyatakan.

Aturan

  • Penempatan. Anda dapat menerapkan atribut ke elemen pemrograman yang paling banyak dideklarasikan. Untuk menerapkan satu atau lebih atribut, Anda menempatkan blok atribut di awal deklarasi elemen. Setiap entri dalam daftar atribut menentukan atribut yang ingin Anda terapkan, dan pengubah dan argumen yang Anda gunakan untuk pemanggilan atribut ini.

  • Kurung Sudut. Jika Anda menyediakan daftar atribut, Anda harus mengapitnya dalam tanda kurung sudut ("<" dan ">").

  • Bagian dari Deklarasi. Atribut harus menjadi bagian dari deklarasi elemen, bukan pernyataan terpisah. Anda dapat menggunakan urutan kelanjutan-baris (" _") untuk memperluas pernyataan deklarasi ke beberapa baris kode-sumber.

  • Pengubah. Pengubah atribut (Assembly atau Module) diperlukan pada setiap atribut yang diterapkan ke elemen pemrograman di awal file sumber. Pengubah atribut tidak diizinkan pada atribut yang diterapkan ke elemen yang tidak berada di awal file sumber.

  • Argumen. Semua argumen posisi untuk atribut harus mendahului penginisialisasi variabel atau properti apa pun.

Contoh

Contoh berikut menerapkan atribut DllImportAttribute ke definisi kerangka dari prosedur Function.

<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 menunjukkan bahwa prosedur yang diatribusikan mewakili titik masuk dalam pustaka tautan-dinamis (DLL) yang tidak dikelola. Atribut memasok nama DLL sebagai argumen posisi dan informasi lainnya sebagai penginisialisasi variabel.

Lihat juga