Mengelola sumber daya aplikasi
File sumber daya adalah file yang merupakan bagian dari aplikasi tetapi tidak dikompilasi, misalnya file ikon atau file audio. Karena file-file ini bukan bagian dari proses kompilasi, Anda dapat mengubahnya tanpa harus mengkombinasikan ulang biner Anda. Jika Anda berencana untuk melokalisasi aplikasi, Anda harus menggunakan file sumber daya untuk semua string dan sumber daya lain yang perlu diubah saat Anda melokalisasi aplikasi Anda.
Perhatian
Sumber daya dalam file dapat diserialisasikan .resx menggunakan BinaryFormatter, yang tidak aman. Sertakan hanya file tersebut .resx dalam proses build yang Anda percayai.
Untuk informasi selengkapnya tentang sumber daya di aplikasi .NET, lihat Sumber Daya di aplikasi .NET.
Bekerja dengan sumber daya
Dalam proyek kode terkelola, buka jendela properti proyek. Anda dapat membuka jendela properti dengan:
- Mengklik kanan simpul proyek di Penjelajah Solusi dan memilih Properti
- Mengetik properti proyek di kotak pencarian CtrlQ+
- Menekan Alt+Enter di Penjelajah Solusi
Pilih tab Sumber Daya . Anda dapat menambahkan file .resx jika proyek Anda belum berisi file tersebut, menambahkan dan menghapus berbagai jenis sumber daya, dan memodifikasi sumber daya yang ada.
Peningkatan Resource Explorer di Visual Studio 2022 dan yang lebih baru
Dimulai dengan Visual Studio 2022 versi 17.11, penjelajah sumber daya telah ditingkatkan secara signifikan. Lihat Memperkenalkan Penjelajah Sumber Daya Visual Studio yang Direvamped.
Untuk menggunakan Resource Explorer baru, Anda harus memiliki proyek .NET yang berisi satu atau beberapa file sumber daya (.resx). Untuk membuka Resource Explorer, klik kanan pada file sumber daya apa pun di Penjelajah Solusi dan pilih Buka Dengan>Resource Explorer. Atau, Anda dapat menggunakan pintasan keyboard Ctrl+Alt+R.
Saat membuka Resource Explorer baru, di sisi kiri, Anda akan melihat gambaran umum semua sumber daya yang telah Anda simpan bersama lokal untuk setiap file. Anda dapat mengonfigurasi lokal mana yang terlihat di datagrid. Antarmuka ini memungkinkan Anda membandingkan terjemahan secara berdampingan dan mengeditnya di tempat.
Mencari string sumber daya
Di kiri atas kisi, Anda dapat menggunakan kotak pencarian untuk melakukan teks pencarian semua file sumber daya Anda. Untuk mencari sumber daya, ketik di kotak pencarian pada toolbar dan tekan Enter. Kisi data hanya akan menampilkan sumber daya yang cocok dengan kueri Anda dalam nama, nilai, atau komentarnya. Anda dapat menggunakan kartubebas (*) untuk melakukan kecocokan parsial, dan tanda kutip (") untuk melakukan kecocokan yang tepat.
Menambahkan komentar ke terjemahan sumber daya tertentu
Komentar adalah cara yang berguna untuk memberikan informasi atau konteks lebih lanjut untuk sumber daya, seperti arti, penggunaan, atau nada string. Di Resource Explorer, Anda dapat menambahkan komentar ke setiap terjemahan sumber daya dan menampilkan semuanya sekaligus di kisi data.
Untuk menambahkan komentar ke sumber daya, pilih sel yang sesuai dengan terjemahan yang ingin Anda komentari, dan klik tombol Edit Komentar pada toolbar, atau tekan Shift+Enter. Kotak komentar muncul di bawah sel, tempat Anda bisa mengetikkan komentar Anda. Tekan Enter untuk menyimpan komentar, atau Esc untuk membuangnya.
Anda dapat mengedit atau menghapus komentar yang ada dengan mengklik kotak komentar atau menggunakan pintasan keyboard yang sama. Untuk melihat semua komentar untuk sumber daya, cari ikon segitiga kecil di sudut setiap sel yang memiliki komentar. Anda dapat mengarahkan mouse ke atas ikon untuk melihat tipsalat dengan teks komentar atau mengkliknya untuk membuka kotak komentar.
Komentar tersedia untuk beberapa pengguna file sumber daya. Penerjemah, pengembang, atau manajer sumber daya dapat meninggalkan catatan, pertanyaan, penjelasan, atau peringatan bersama terjemahan. Ikon kecil di sudut setiap sel menunjukkan adanya komentar.
Filter sumber daya
Untuk memfilter sumber daya, klik ikon filter pada toolbar dan pilih kriteria yang ingin Anda terapkan. Anda dapat memfilter sumber daya menurut nama, nilai, komentar, jenis, atau file.
| Filter | Deskripsi |
|---|---|
| Nama | Perlihatkan hanya sumber daya yang memiliki nama atau awalan tertentu. |
| Nilai | Perlihatkan hanya sumber daya yang memiliki nilai tertentu atau berisi string tertentu. |
| Komentar | Perlihatkan hanya sumber daya yang memiliki komentar atau berisi string tertentu dalam komentarnya. |
| Jenis | Perlihatkan hanya sumber daya yang memiliki jenis tertentu, seperti string, gambar, atau ikon. |
| File | Perlihatkan hanya sumber daya yang termasuk dalam file atau budaya tertentu. |
Anda dapat menggabungkan beberapa filter untuk mempersempit hasil Anda dan menghapusnya dengan mengklik tombol Hapus Filter.
Validasi dan peringatan
Tempat penampung adalah token khusus yang digantikan oleh nilai dinamis saat runtime, seperti {0}, , {1}atau {name}. Jika Anda menggunakan tempat penampung di sumber daya, Anda perlu memastikannya konsisten di semua pelokalan, jika tidak, Anda mungkin melihat kesalahan atau perilaku tak terduga di aplikasi Anda.
Resource Explorer baru secara otomatis memvalidasi tempat penampung untuk setiap sumber daya dan menunjukkan ikon peringatan jika ada ketidakcocokan antara budaya default dan pelokalan lainnya. Misalnya, jika nilai default sumber daya adalah "Hello, {name}!" dan nilai Spanyol adalah "Hola, {nombre}!", Anda akan melihat ikon peringatan yang menunjukkan bahwa nama tempat penampung berbeda. Anda dapat mengarahkan mouse ke atas ikon untuk melihat tipsalat dengan detail ketidakcocokan dan mengkliknya untuk memperbaikinya.
Terjemahan yang hilang adalah masalah umum lain yang dapat memengaruhi pengalaman pengguna aplikasi Anda. Jika Anda tidak memberikan terjemahan untuk sumber daya dalam budaya tertentu, aplikasi akan kembali ke budaya default, yang mungkin tidak tepat atau diinginkan untuk beberapa pengguna. Resource Explorer membantu Anda menghindari masalah ini dengan menampilkan ikon peringatan jika tidak ada nilai untuk sumber daya dalam budaya tertentu. Misalnya, jika> Anda memiliki sumber daya dengan nilai File default dan tidak ada nilai untuk budaya Prancis, Anda akan melihat ikon peringatan yang menunjukkan bahwa terjemahan hilang. Anda dapat mengarahkan mouse ke atas ikon untuk melihat tipsalat dengan pesan Tidak ada nilai dan memilihnya untuk menambahkan nilai.
Opsi penyesuaian
Resource Explorer di Visual Studio 2022 dan yang lebih baru kompatibel dengan pembaca layar dan teknologi bantuan, untuk membuatnya lebih mudah diakses oleh pengembang dengan gangguan atau disabilitas visual. Anda dapat menggunakan pintasan keyboard untuk menavigasi melalui kisi data, mengedit nilai dan komentar, dan melakukan tindakan umum. Anda juga dapat menggunakan narator untuk membaca konten setiap sel, serta tipsalat dan peringatan.
Untuk menyesuaikan tingkat perbesar tampilan, gunakan penggeser zoom pada toolbar, atau pintasan keyboard Ctrl+= dan Ctrl+-, untuk memperbesar atau memperkecil. Gunakan Ctrl+0 untuk mengatur ulang tingkat perbesar tampilan ke default.
Tema untuk Resource Explorer konsisten dengan lingkungan Visual Studio lainnya. Anda dapat memilih antara tema terang, gelap, atau biru, dan Resource Explorer akan beradaptasi dengan sesuai. Anda juga dapat mengubah font dan warna kisi data, dengan menggunakan dialog Font dan Warna Lingkungan>Opsi>Alat>.
Sumber daya dalam jenis proyek lain
Sumber daya dikelola secara berbeda dalam proyek .NET daripada di jenis proyek lainnya. Untuk informasi selengkapnya tentang sumber daya di:
- aplikasi Platform Windows Universal (UWP), lihat Sumber daya aplikasi dan Sistem Manajemen Sumber Daya
- Proyek C++/CLI (terkelola), lihat Sumber Daya di Aplikasi Desktop
- Proyek C++, lihat Bekerja dengan file sumber daya dan Cara: Membuat sumber daya
- Gunakan jendela Tampilan Sumber Daya (Lihat>Tampilan Sumber Daya Windows>Lainnya) untuk menampilkan file sumber daya yang disertakan dalam proyek Anda.
Opsi dukungan
Jika Anda mengalami masalah dalam mengelola sumber daya aplikasi, lihat Memecahkan masalah kesalahan di Editor Sumber Daya.