Nama Elemen Yang Dideklarasikan (Visual Basic)

2025-06-17

Setiap elemen yang dideklarasikan memiliki nama, juga disebut pengidentifikasi, yang digunakan kode untuk merujuknya.

Aturan

Nama elemen di Visual Basic harus mengamati aturan berikut:

Ini harus dimulai dengan huruf alfabet atau garis bawah (_).
Ini hanya boleh berisi karakter alfabet, digit desimal, dan garis bawah.
Ini harus berisi setidaknya satu karakter alfabet atau digit desimal jika diawali dengan tanda garis bawah.
Panjangnya tidak boleh lebih dari 1023 karakter.

Batas panjang 1023 karakter juga berlaku untuk seluruh string nama yang sepenuhnya memenuhi syarat, seperti outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

Contoh berikut menunjukkan beberapa nama elemen yang valid.

aB123__45

_567

Contoh berikut menunjukkan beberapa nama elemen yang tidak valid. Yang pertama hanya berisi garis bawah, yang kedua dimulai dengan digit desimal, dan yang ketiga berisi karakter yang tidak valid ($).

' Three INVALID element names

_

12ABC

xyz$wv

Perhatian

Nama elemen yang dimulai dengan garis bawah (_) bukan bagian dari Kemandirian Bahasa dan Komponen Language-Independent (CLS), sehingga kode yang mematuhi CLS tidak dapat menggunakan komponen yang menentukan nama tersebut. Namun, garis bawah di posisi lain dalam nama elemen mematuhi CLS.

Panduan Panjang Nama

Sebagai masalah praktis, nama Anda harus sesingkat mungkin sambil tetap mengidentifikasi sifat elemen dengan jelas. Ini meningkatkan keterbacaan kode Anda dan mengurangi panjang baris dan ukuran file sumber.

Di sisi lain, nama Anda tidak boleh begitu singkat sehingga tidak cukup menggambarkan apa yang diwakili elemen dan bagaimana kode Anda menggunakannya. Ini penting untuk keterbacaan kode Anda. Jika orang lain mencoba memahaminya, atau jika Anda sendiri melihatnya dalam waktu yang lama setelah Anda menulisnya, nama elemen yang cocok dapat menghemat banyak waktu.

Nama yang Lolos

Umumnya, nama elemen tidak boleh cocok dengan kata kunci apa pun yang dicadangkan oleh Visual Basic, seperti Case atau Friend. Namun, Anda dapat menentukan nama yang lolos, yang diapit oleh tanda kurung siku ([ ]). Nama yang diloloskan dapat cocok dengan kata kunci Visual Basic mana pun, karena tanda kurung menghilangkan ambiguitas apa pun. Anda juga menggunakan tanda kurung saat merujuk ke nama nanti dalam kode Anda.

Secara umum, Anda hanya harus menggunakan nama yang di-escape ketika:

Kode Anda telah dimigrasikan dari versi Visual Basic sebelumnya yang tidak memesan kata kunci yang digunakan sebagai nama; atau
Anda bekerja dengan kode yang ditulis dalam bahasa lain di mana kata kunci yang digunakan tidak bersifat khusus.

Jika tidak, Anda harus mempertimbangkan untuk mengganti nama elemen jika namanya bertentangan dengan kata kunci. Lingkungan pengembangan terintegrasi (IDE) menyediakan cara mudah untuk melakukan ini. Untuk informasi selengkapnya, lihat Pemfaktoran ulang.

Sensitivitas Kasus dalam Nama

Nama elemen di Visual Basic tidak peka terhadap penggunaan huruf besar atau kecil. Ini berarti bahwa ketika pengkompilasi membandingkan dua nama yang berbeda dalam kasus alfabet saja, itu menafsirkannya sebagai nama yang sama. Misalnya, ia mempertimbangkan ABC dan abc merujuk ke elemen yang dideklarasikan yang sama.

Namun, runtime bahasa umum (CLR) menggunakan pengikatan yang peka terhadap huruf besar/kecil. Oleh karena itu, ketika Anda menghasilkan sebuah assembly atau DLL dan membuatnya tersedia untuk rakitan lain, nama Anda tidak lagi memperhatikan perbedaan huruf besar/kecil. Misalnya, jika Anda mendefinisikan kelas dengan elemen yang disebut ABC, dan kumpulan lainnya menggunakan kelas Anda melalui common language runtime, mereka harus merujuk ke elemen sebagai ABC. Jika Anda kemudian mengkombinasikan ulang kelas Anda dan mengubah nama elemen menjadi abc, rakitan lain yang menggunakan kelas Anda tidak dapat lagi mengakses elemen tersebut. Oleh karena itu, ketika Anda merilis versi rakitan yang diperbarui, Anda tidak boleh mengubah kasus alfabet elemen publik apa pun.

Nama dan Lokasi

Perbandingan nama tidak bergantung pada lokal. Jika dua nama cocok dalam satu lokal, nama tersebut dijamin cocok di semua lokal.

Bagikan melalui