Melihat dan mengubah nilai variabel dengan petunjuk data di editor kode
Artikel ini membahas cara bekerja dengan fitur tips data di Visual Studio. Tips data menyediakan cara mudah untuk melihat informasi tentang variabel dalam program Anda saat Anda men-debug kode Anda. Saat Anda mengatur titik henti dalam kode Anda dan memulai penelusuran kesalahan, tips data terlihat untuk variabel saat memasuki cakupan eksekusi saat ini. Anda dapat menggunakan petunjuk data untuk mengubah nilai variabel yang tercakup, dan menjalankan ulang kode melewati titik henti untuk melihat pengaruh perubahan.
Saran
Jika Anda baru mulai belajar debugging, Anda mungkin ingin membaca Debugging untuk pemula absolut dan teknik dan alat debugging sebelum Anda mempelajari artikel ini.
Prasyarat
Visual Studio. Jika Anda tidak memiliki Visual Studio, buka halaman unduhan Visual Studio untuk menginstalnya secara gratis.
Beberapa kode program untuk dijalankan di debugger Visual Studio.
Bekerja dengan petunjuk data
Petunjuk data akan muncul selama sesi debugging ketika Anda telah menetapkan breakpoint dalam kode Anda. Ketika debugger menjeda eksekusi program pada titik henti, petunjuk data tersedia untuk semua variabel dalam cakupan saat ini.
Berikut prosesnya:
Atur titik henti dalam kode Anda, dan mulai penelusuran kesalahan dengan memilih Debug>Mulai Penelusuran Kesalahan atau gunakan pintasan keyboard F5.
Saat debugger menghentikan eksekusi di titik berhenti, arahkan kursor ke variabel apa pun dalam cakupan saat ini untuk membuka tips data.
Gunakan tip data untuk melihat nama variabel dan berinteraksi dengan nilai.
Sesuai kebutuhan, ubah nilai untuk variabel atau tambahkan komentar.
Nota
Visual Studio mengevaluasi dan menampilkan nilai variabel dalam jendela informasi berdasarkan konteks tempat debugger dijeda selama eksekusi. Evaluasi tidak didasarkan pada lokasi kursor atau tip data saat ini. Jika Anda mengarahkan mouse ke atas variabel dalam fungsi lain yang memiliki nama yang sama dengan variabel dalam konteks saat ini, Visual Studio menampilkan nilai variabel dalam tip data untuk konteks saat ini.
Visual Studio mendukung banyak tindakan untuk tips data dan bekerja dengan variabel dan nilai, termasuk:
- Sematkan atau apungkan tip data agar tetap terlihat saat eksekusi kode berlanjut
- Aktifkan petunjuk data lengket yang tetap dalam keadaan diperluas hingga Anda memilih di tempat lain.
- Perluas tooltip untuk array, struktur, atau objek untuk melihat anggotanya dalam format pohon
- Mengubah nilai untuk variabel dalam tip data
- Tambahkan komentar multibaris ke tip data yang disematkan untuk mencatat selama debugging
- Tips mengimpor dan mengekspor data
Menjadikan petunjuk data transparan
Saat mengarahkan mouse ke atas variabel untuk melihat tip data, Anda dapat membuat tip data transparan untuk melihat kode di bawahnya. Tindakan ini juga mengaktifkan transparansi untuk tindakan tip lain di editor kode, seperti definisi metode dan sintaks ekspresi.
Untuk mengaktifkan transparansi, ikuti langkah-langkah berikut:
Di editor Visual Studio Code, pilih bagian dalam data tip, lalu tekan dan tahan Ctrl.
Untuk mempertahankan transparansi, terus tahan Ctrl.
Untuk mengakhiri transparansi, berhenti memilih Ctrl atau pilih di tempat lain.
Transparansi tidak tersedia untuk tip data yang dipasangkan atau mengambang.
Pertahankan tips data tetap terbuka
Di Visual Studio 2022 Update 1 dan yang lebih baru, saat memperluas tip data, Anda dapat membuatnya diperluas hingga Anda memilih di tempat lain. Tindakan ini menghasilkan tip data lengket .
Untuk membuat tip data lengket, ikuti langkah-langkah berikut:
Di Visual Studio, pilih opsi Debug> untuk membuka dialog Opsi.
Di tab Umum, gulir untuk menemukan opsi Tetap buka tips data yang diperluas hingga diklik.
Pilih kotak centang untuk mengaktifkan opsi lengket, dan pilih OK.
Saat opsi lengket diaktifkan, jika Anda memperluas tip data apa pun di editor kode, opsi tersebut tetap diperluas.
Menyematkan tips data
Anda dapat memasang petunjuk data agar tetap terbuka di permukaan editor kode. Anda juga dapat mengubah lokasi tip data yang disematkan.
Untuk menyematkan tip data, ikuti langkah-langkah berikut:
Di editor Visual Studio Code, arahkan mouse ke atas variabel untuk menampilkan tip data.
Di tips data, gunakan pushpin untuk memilih pin ke sumber:
Visual Studio menyematkan tip data ke lokasi yang berdekatan dengan variabel pada permukaan kode. Pushpin muncul di selokan editor kode di samping baris tempat Anda menyematkan tip data.
Pilih dan seret tip data yang disematkan ke lokasi mana pun di area kerja editor kode.
Lepas sematan tip data
Setelah menyematkan tip data, Anda dapat melepaskan semat tip data dan membuatnya mengambang. Tip data mengambang dapat diposisikan di mana saja di Visual Studio IDE.
Untuk memunculkan tip data, ikuti langkah-langkah berikut:
Dalam tip data yang disematkan, gunakan pushpin untuk memilih Lepaskan dari sumber.
Visual Studio melepaskan pin pada tip data dan memberikan tip data latar belakang dengan warna solid. Pushpin untuk tip data berubah ke posisi tidak disematkan, dan pushpin di bilah samping editor kode dihapus.
Pilih dan seret tip data mengambang ke lokasi mana pun di Visual Studio IDE.
Jika Anda memposisikan petunjuk data mengambang di luar permukaan editor kode, pushpin akan dihapus dari menu samping petunjuk data. Opsi Sematkan ke sumber hanya tersedia ketika tip data mengambang diposisikan pada permukaan editor kode.
Tips untuk merepin data
Setelah menampilkan tip data, Anda dapat menyematkannya kembali ke lokasi sumber tertentu di permukaan editor kode.
Untuk memasang kembali tip data mengambang, ikuti langkah-langkah berikut:
Pilih dan pindahkan tip data mengambang, dan posisikan di permukaan editor kode.
Di tip data mengambang, gunakan pushpin untuk memilih pin ke sumber.
Paku payung berubah ke posisi yang disematkan. Petunjuk data dijepit ulang ke lokasi tertentu di editor kode, dan pushpin untuk sumber muncul di bagian tepi editor kode.
Tutup tip data
Ada beberapa cara untuk menutup tips data di Visual Studio.
Saat Anda mengakhiri sesi penelusuran kesalahan, jika Anda memiliki tips data terbuka, Visual Studio akan menutupnya untuk Anda. Jika Anda meluncurkan sesi debugging lain, Visual Studio mencoba mengembalikan data tips apa pun yang sebelumnya Anda tinggalkan terbuka.
Tabel berikut ini meringkas bagaimana Anda bisa menutup tips data secara manual:
| Tutup sasaran | Perbuatan |
|---|---|
| Tip data tertentu | Pilih X di kotak informasi data. |
| Semua petunjuk data untuk berkas tertentu | Pilih Debug>Hapus Semua DataTips yang Disematkan ke <Nama File> pada toolbar Visual Studio. |
| Semua tips terkait data terbuka | Pilih Debug>Clear All DataTips pada toolbar Visual Studio. |
Bekerja dengan variabel dan nilai dalam petunjuk mengenai data
Ketika Anda bekerja dengan petunjuk data di Visual Studio, Anda mendapatkan kemampuan untuk melihat detail tentang variabel dan objek, dan mengedit nilai selama debugging. Kemampuan ini berguna untuk pemecahan masalah cepat dan menguji perubahan pada kode Anda.
Memperluas objek dalam tips data untuk melihat anggota
Saat tip data mewakili array, struktur, atau objek, Anda dapat memperluas tampilan tip data untuk melihat anggota. Tampilan yang diperluas memperlihatkan informasi tambahan dalam format pohon hierarkis.
Untuk memperluas tampilan objek dalam tip data, ikuti langkah-langkah berikut:
Dalam tip data untuk array, struktur, atau objek, pilih panah perluas sebelum nama item untuk memperlihatkan anggota. Tampilan disajikan dalam format pohon:
Untuk tip data yang disematkan, pilih simbol plus (+) sebelum nama variabel untuk memperluas definisi.
Lanjutkan untuk memilih panah perluas untuk melihat lebih banyak hierarki anggota:
Untuk berpindah ke atas dan ke bawah dalam tampilan yang diperluas, gunakan tombol panah mouse atau keyboard Atas dan Bawah.
Untuk menyematkan anggota yang diperluas dengan data asli yang sudah disematkan, gunakan tanda pushpin pada anggota tersebut untuk memilih Pin ke sumber. Setelah Anda menciutkan tampilan pohon, elemen anggota yang disematkan tetap terlihat dengan tip data yang disematkan.
Mengedit nilai variabel
Keuntungan lain dari bekerja dengan tips data adalah kemampuan untuk mengedit nilai variabel atau elemen dalam tip data selama debugging. Fungsionalitas ini berguna untuk pengujian cepat perubahan kecil pada kode Anda.
Untuk mengedit nilai variabel atau elemen dalam tip data, ikuti langkah-langkah berikut:
Pada petunjuk data, pilih nilai. Visual Studio menyoroti nilai dan membuatnya tersedia untuk pengeditan.
Masukkan nilai baru di tip data, dan pilih Masukkan.
Perlu diingat bahwa beberapa nilai variabel hanya dibaca. Visual Studio tidak memungkinkan nilai hanya-baca untuk diedit.
Gunakan komentar dalam tips tentang data
Bagian Komentar dari tip data berguna untuk menyimpan catatan tentang variabel saat Anda melakukan debug kode Anda. Bagian ini adalah tempat yang nyaman untuk melacak berbagai nilai saat mereka berubah selama penelusuran kesalahan. Anda dapat menambahkan komentar dalam tip data yang disematkan atau mengambang.
Untuk menggunakan Komentar dalam petunjuk data, ikuti langkah-langkah berikut:
Dalam tips data, gunakan Panah Bawah ganda untuk memilih Perluas tampilan untuk melihat komentar. Panah bawah ganda membuka Komentar wilayah tip data tempat Anda bisa menambahkan catatan.
Untuk menambahkan komentar, sisipkan kursor Anda di bagian Komentar dan masukkan teks. Kawasan menerima beberapa garis.
Untuk menutup bagian Komentar, gunakan dua panah ke atas untuk Sembunyikan komentar. Komentar apa pun yang Anda masukkan tetap terkait dengan tips data, tetapi saat ini tidak terlihat.
Menyematkan properti dalam tips data
Visual Studio mendukung penyematan fitur dalam tips data yang sudah disematkan di .NET Core 3.0 dan yang lebih baru. Fitur ini memungkinkan Anda memeriksa objek dengan cepat berdasarkan propertinya dalam tips data.
Untuk menyematkan properti dalam tips data, ikuti langkah-langkah berikut:
Dalam tips data yang disematkan, perluas hierarki anggota hingga Anda menemukan properti yang ingin dipertahankan terlihat bersama dengan tips data.
Gunakan pushpin untuk properti untuk menyematkannya dengan tip data. Anda juga dapat mengklik kanan properti dan memilih Sematkan Anggota Sebagai Favorit.
Visual Studio memindahkan properti yang dipilih ke bagian atas daftar properti objek. Nama dan nilai properti ditampilkan di kolom kanan pada tip data yang disematkan.
Untuk melepaskan pin dari properti dalam tip data, pilih pushpin untuk properti lagi atau klik kanan pada properti dan pilih Lepaskan Anggota Sebagai Favorit.
Anda juga dapat mengubah visibilitas nama properti dan memfilter properti yang tidak dipin dalam daftar properti objek dalam tip data.
Untuk memfilter properti yang tidak ditandai, klik kanan baris properti di keterangan data, dan pilih Perlihatkan Hanya Anggota yang Ditandai.
Untuk mengalihkan visibilitas nama properti, klik kanan baris properti di tip data, dan pilih Sembunyikan Nama Anggota yang Disematkan di Nilai.
Gambar berikut menunjukkan berbagai opsi pada menu klik kanan untuk hierarki anggota dalam tooltip data:
Dapatkan bantuan AI
Jika Anda memiliki Copilot, Anda bisa mendapatkan bantuan AI saat meneliti variabel dalam petunjuk data. Klik kanan pada variabel dan gunakan tombol untuk meminta Copilot.
Tombol. Dalam skenario ini, Copilot sudah mengetahui konteks untuk pertanyaan Anda, jadi Anda tidak perlu memberikan konteks sendiri dalam obrolan. Untuk informasi lebih lanjut, lihat Debug dengan Copilot.
Memvisualisasikan jenis data kompleks
Visualizer menampilkan informasi dengan cara yang lebih bermakna, dan terkadang grafis. Contoh visualizer termasuk XML, HTML, JSON, dan Text Visualizer. Anda dapat menggunakan visualisasi dalam kode Anda untuk memeriksa jenis data kompleks selama debugging.
Jika visualizer tersedia untuk sebuah elemen, Visual Studio akan menampilkan ikon kaca pembesar bertuliskan Lihat di samping nama elemen pada tip data. Saat Anda memilih visualisasi, Visual Studio membuka jendela terpisah untuk menampilkan data kompleks dalam format yang dapat dibaca.
Anda dapat menggunakan fitur ini untuk memilih visualisasi untuk data Anda:
Untuk melihat elemen dengan menggunakan visualizer default untuk jenis data, pilih kaca pembesar. ikon Visualizer
Untuk memilih visualizer tertentu, perluas daftar dropdown Lihat di samping kaca pembesar dan pilih opsi.
Menambahkan variabel ke jendela Watch
Anda dapat terus menonton variabel dengan menambahkannya ke jendela Visual Studio Watch dari tip data:
- Dalam tips data, klik kanan nama variabel dan pilih Tambahkan Watch.
Visual Studio menambahkan variabel di jendela Watch. Jika edisi Visual Studio Anda mendukung beberapa jendela Watch, variabel akan muncul di jendela berlabel Watch 1.
Tips mengimpor dan mengekspor data
Anda dapat mengekspor tips data ke file XML, yang dapat Anda bagikan atau edit dengan menggunakan editor teks. Anda juga dapat mengimpor tips data dari file XML yang Anda terima atau diedit sebelumnya.
Untuk mengekspor tips data, ikuti langkah-langkah berikut:
Di Visual Studio, pilih Debug>Export DataTips. Dialog Ekspor Tip Data terbuka.
Dalam dialog, telusuri ke lokasi tempat Anda ingin menyimpan file XML.
Masukkan nama untuk file ekspor, dan pilih Simpan.
Visual Studio mengekspor tips data Anda ke file dan lokasi yang ditentukan.
Untuk mengimpor tips data dari file, ikuti langkah-langkah berikut:
Di Visual Studio, pilih Debug>Impor DataTips. Dialog Impor Tip Data terbuka.
Dalam dialog, telusuri ke lokasi file XML tips data yang akan digunakan untuk impor.
Pilih file yang akan dibuka, dan pilih Buka.
Visual Studio mengimpor tips data dari file yang ditentukan ke ruang kerja Anda saat ini. Saat Anda melakukan debug kode ruang kerja, tips data yang diimpor tersedia.
Konten terkait
- Dapatkan tampilan pertama pada debugger Visual Studio
- Jelajahi teknik dan alat debugging
- Membuat tampilan data kustom di debugger Visual Studio