Menggunakan cuplikan kode di Visual Studio

Cuplikan kode adalah blok kecil kode yang dapat digunakan kembali yang dapat Anda tambahkan ke file kode. Cuplikan biasanya mencakup konstruksi yang sering digunakan, seperti blok Try...Finally atau If...Else. Anda juga dapat menggunakan cuplikan untuk menambahkan seluruh kelas atau metode.

Cuplikan kode memiliki judul yang Anda gunakan untuk memilihnya dan dapat memiliki pintasan yang Anda ketik untuk menyisipkannya. Cuplikan juga dapat berisi parameter pengganti, yang bertindak sebagai placeholder. Visual Studio menyediakan cuplikan untuk banyak bahasa, termasuk C#, C++, dan Visual Basic.

Prasyarat

  • Visual Studio dengan dukungan yang diinstal untuk bahasa pemrograman yang ingin Anda gunakan. Cuplikan yang tersedia bergantung pada beban kerja dan komponen bahasa yang diinstal.
  • File kode terbuka di editor dan dikenali oleh layanan bahasa yang sesuai. Untuk contoh C++, buka .cpp file atau .h .

Memahami jenis cuplikan

Visual Studio mendukung dua jenis cuplikan kode:

  • Cuplikan ekspansi menambahkan kode pada titik penyisipan tertentu.
  • Cuplikan bungkus-dengan menambahkan kode di sekeliling kode yang dipilih. Cuplikan "surround with" hanya tersedia untuk C# dan C++.

Menemukan cuplikan yang tersedia

Untuk melihat cuplikan yang diinstal untuk bahasa, pilihPengelola Cuplikan KodeAlat> atau tekan Ctrl+K, Ctrl+B. Di Manajer Cuplikan Kode, pilih bahasa dari daftar Bahasa .

Untuk membuat dan mengimpor cuplikan Anda sendiri sehingga muncul di daftar cuplikan, lihat Panduan: Membuat cuplikan kode di Visual Studio.

Nota

Pintasan keyboard dapat bervariasi menurut profil pengaturan, konteks, tata letak keyboard, dan pengikatan kunci kustom. Untuk menemukan pengikatan untuk perintah, lihat Mengidentifikasi dan menyesuaikan pintasan keyboard.

Sisipkan cuplikan perluasan

Cuplikan ekspansi menyisipkan kode di titik penyisipan. Misalnya, cuplikan C# tryf menambahkan try/finally blok:

try
{

}
finally
{

}

Anda harus menyisipkan cuplikan tryf di tempat pernyataan valid, misalnya di dalam metode, indeksator, aksesor properti, atau aksesor peristiwa.

  1. Di editor kode, posisikan kursor di mana Anda ingin menambahkan potongan kode.

  2. Ikuti salah satu tindakan berikut:

    • Pada bilah menu, pilih Edit>IntelliSense>Sisipkan Cuplikan.
    • Klik kanan dan pilih Cuplikan>Sisipkan Cuplikan.
    • Tekan Ctrl+K, Ctrl+X.
  3. Di pemilih cuplikan, buka folder Visual C# , lalu klik dua kali tryf. Anda juga dapat memilih tryf dan menekan Tab atau Enter.

Blok try/finally muncul di titik penyisipan, siap untuk Anda kustomisasi.

Petunjuk / Saran

Pada titik penyisipan yang valid, ketik tryf, lalu tekan Tab dua kali untuk memperluas cuplikan tanpa membuka pemilih cuplikan.

Mengelilingi kode yang dipilih dengan cuplikan

Cuplikan surround-with membungkus kode yang dipilih. Misalnya, cuplikan C++ if membungkus baris return FALSE; yang dipilih dalam if blok:

if (true)
{
    return FALSE;
}

Untuk mengelilingi kode C++ yang dipilih:

  1. Dalam file .cpp atau .h , pilih kode yang ingin Anda bungkus.

  2. Ikuti salah satu tindakan berikut:

    • Pada bilah menu, pilih Edit>IntelliSense>Surround With.
    • Klik kanan dan pilih Apit dengan.
  3. Di pemilih cuplikan, klik dua kali jika, atau pilih jika dan tekan Tab atau Enter.

Blok if muncul di sekeliling kode yang dipilih. Ganti placeholder true dengan kondisi yang ingin Anda evaluasi.

Untuk contoh cuplikan C++ lainnya, lihat Cuplikan kode Visual C++.

Mengedit bidang penggantian

Cuplikan dapat berisi bidang pengganti yang Anda kustomisasi setelah penyisipan. Ketika bidang yang sama muncul lebih dari sekali, mengubah satu kemunculan mengubah semua kemunculan yang ditautkan. Tekan Tab untuk berpindah ke bidang penggantian berikutnya.

Misalnya, cuplikan Visual Basic Define a Property tersebut berisi bidang tertaut untuk variabel pendukung, nama properti, dan jenis properti. Untuk menyisipkannya:

  1. Dalam file kode Visual Basic, klik kanan tempat Anda ingin menyisipkan properti, lalu pilih>Cuplikan Sisipkan Cuplikan.
  2. Pilih Pola Kode>Properti, Prosedur, Peristiwa>Tentukan Properti.

Cuplikan layar pemilih cuplikan Visual Basic dengan Tentukan Properti dipilih di bawah Properti, Prosedur, Peristiwa.

Kode berikut disisipkan:

Private newPropertyValue As String
Public Property NewProperty() As String
    Get
        Return newPropertyValue
    End Get
    Set(ByVal value As String)
        newPropertyValue = value
    End Set
End Property

Jika Anda mengubah newPropertyValue menjadi m_property, setiap instans tertaut dari newPropertyValue akan berubah. Jika Anda mengubah jenis properti dari String menjadi String, setiap instans tertaut dari Integer akan berubah menjadi Integer.

Memecahkan masalah cuplikan kode

Jika cuplikan atau perintah tidak tersedia:

  • Konfirmasikan bahwa Visual Studio mengenali file sebagai bahasa pemrograman yang diharapkan.
  • Konfirmasikan bahwa beban kerja atau komponen bahasa yang diperlukan telah diinstal.
  • Di Tools>Code Snippets Manager, konfirmasikan bahwa cuplikan diinstal untuk bahasa yang dipilih.
  • Jika pintasan keyboard tidak berfungsi seperti yang diharapkan, gunakan Identifikasi dan kustomisasi pintasan keyboard untuk mencari pengikatan perintah saat ini.
  • Periksa apakah titik penyisipan valid untuk cuplikan yang dipilih. Misalnya, beberapa cuplikan C# hanya valid di dalam metode atau deklarasi jenis. Untuk lokasi penyisipan C# yang valid, lihat cuplikan kode C#.

Tinjau kode yang disisipkan oleh snippet

Kode cuplikan menunjukkan cara dasar untuk melakukan tugas. Tinjau dan sesuaikan kode yang dihasilkan sebelum Anda menggunakannya dalam aplikasi. Pertimbangkan bagaimana kode menangani pengecualian, mengakses sumber daya, memvalidasi input, dan melindungi rahasia.

Perlakukan cuplikan yang diunduh dari internet seperti kode lain yang diunduh. Unduh cuplikan hanya dari sumber yang Anda percayai, dan periksa kode cuplikan dan metadata sebelum Anda mengimpor atau menjalankannya.

Dalam proyek .NET Framework, cuplikan dapat menggunakan References elemen untuk menambahkan referensi proyek. Tinjau elemen Imports dan References, lalu pastikan bahwa Anda memercayai assembly yang dirujuk. Untuk informasi selengkapnya, lihat Mengimpor namespace dan referensi skema cuplikan kode.

Baca juga