Winres.exe (Editor Pelokalan Sumber Daya Windows)

Artikel
05/09/2023

Editor Pelokalan Sumber Daya Windows, Winres.exe, adalah alat tata letak visual yang membantu pakar pelokalan melokalkan sumber daya antarmuka pengguna (UI) Formulir Windows yang digunakan oleh formulir. Anda dapat membuat file .resx atau .resources yang digunakan sebagai input untuk Winres.exe menggunakan lingkungan desain visual seperti Microsoft Visual Studio. Untuk informasi tentang menyebarkan sumber daya di aplikasi .NET Framework, lihat Sumber Daya di aplikasi .NET.

Winres.exe terpasang dengan Visual Studio. Untuk menjalankan alat ini, gunakan Perintah Pengembang Visual Studio atau PowerShell Pengembang Visual Studio.

Peringatan

Jangan buka file yang tidak tepercaya dengan alat ini. Jika file adalah file biner, file tersebut akan dideserialisasi menggunakan deserialisasi biner, yang tidak aman. Untuk informasi selengkapnya, lihat Risiko deserialisasi dalam penggunaan BinaryFormatter dan jenis terkait.

Sintaks

winres resourceFile
winres /?

Argumen

Argumen	Deskripsi
`resourceFile`	File sumber daya untuk dilokalkan. File ini harus berupa file .resx atau .resources formulir Formulir Windows yang dihasilkan oleh perancang Visual Studio. Winres.exe tidak dapat membuka file .resx atau .resources generik.

Opsi	Deskripsi
/?	Menampilkan sintaks perintah dan opsi untuk alat ini.

Keterangan

Status elemen UI dari formulir dalam proyek Formulir Windows biasanya disimpan dalam file sumber daya, yang merupakan file berbasis XML dengan ekstensi .resx atau versi biner yang dikompilasi yang sesuai dengan ekstensi .resources. Winres.exe adalah alat yang memungkinkan pengeditan terbatas dari salah satu jenis file di luar lingkungan desain Visual Studio. Secara khusus, ini memungkinkan jenis operasi pengeditan berikut:

File sumber budaya netral atau spesifik dapat diedit untuk mengubah properti UI formulir atau kontrolnya, seperti teks, ukuran, atau posisinya.
File sumber budaya netral atau spesifik dapat dihasilkan dari file sumber default.
File sumber budaya dapat disimpan sebagai file sumber budaya lain. Misalnya, file sumber Bahasa Inggris (A.S.) dapat disimpan sebagai file sumber Polandia. Biasanya file baru selanjutnya akan diedit agar kompatibel dengan budaya baru.

Lihat juga Organisasi Hierarkis Sumber Daya untuk Pelokalan atau Organisasi Hierarkis Sumber Daya untuk Pelokalan.

Winres.exe tidak dapat mengonversi file .resx ke dalam file .resources yang sesuai; gunakan alat Resgen.exe sebagai gantinya. Untuk informasi selengkapnya tentang Resgen.exe, lihat Resgen.exe (Generator File Sumber).

Winres.exe adalah aplikasi grafis yang membuat ulang versi waktu desain dari formulir Formulir Windows hanya dari file sumber, tanpa memiliki akses ke kode sumber. Winres.exe menghosting jendela Visual Studio Desainer Formulir dan Properti Formulir Windows. Fitur-fitur ini memungkinkan pengeditan visual file .resources atau .resx yang berisi formulir Formulir Windows. Biasanya, pelokalan menggunakan Winres.exe untuk mengedit label kontrol dan menyesuaikan lokasi dan ukuran kontrol untuk mengakomodasi label untuk budaya target.

Jika Winres.exe tidak dapat menyelesaikan jenis kontrol, itu membuat kontrol tempat penampung di file .resx atau .resources yang dilokalkan. Kontrol tempat penampung muncul di formulir Formulir Windows sebagai jendela yang muncul. Ukuran dan posisi jendela yang muncul cocok dengan kontrol aktual. Semua properti yang dapat dilokalkan yang tersedia untuk kontrol tempat penampung muncul di jendela Properti. Setiap perubahan yang Anda buat pada kontrol tempat penampung disimpan untuk kontrol aktual.

Winres.exe versus Visual Studio

Secara umum, sebelum Anda mulai melokalkan formulir Formulir Windows aplikasi, Anda harus memutuskan apakah Anda ingin menggunakan Visual Studio atau Winres.exe sebagai alat pelokalan. Kompatibilitas versi, seperti yang dijelaskan nanti, dapat mencegah Anda beralih dari satu alat ke alat lainnya.

Keuntungan dari Visual Studio adalah Anda dapat menggunakannya untuk mengembangkan dan melokalisasi aplikasi. Untuk melokalisasi formulir, setelah pengembangan selesai, atur formulir dengan LocalizableAttribute (properti yang Dapat Dilokalkan di editor Properti) ke true dan ubah properti Bahasanya ke budaya target yang diinginkan. Kemudian, edit string dan sesuaikan lokasi dan ukuran kontrol untuk mengakomodasi string untuk budaya target. Saat Anda menyimpan file .resx yang dilokalkan, Visual Studio hanya menulis properti yang dapat dilokalkan (properti yang diubah dalam budaya target) ke file. Visual Studio secara otomatis membuat rakitan satelit untuk file .resx yang dilokalkan di lokasi direktori yang benar.

Meskipun Visual Studio menyediakan lingkungan pengembangan dan pelokalan terintegrasi, Winres.exe adalah alat yang disarankan untuk digunakan jika pelokalan dilakukan oleh pelokalan pihak ketiga. Karena Winres.exe hanya alat pelokalan, ini memungkinkan pemisahan yang lebih bersih antara kode aplikasi dari formulir yang akan dilokalkan, yang lebih praktis untuk mengelola proyek besar.

Menggunakan Winres.exe

Untuk melokalisasi menggunakan Winres.exe, Anda harus terlebih dahulu mengembangkan aplikasi menggunakan perancang visual seperti Perancang Formulir Windows di Visual Studio. Ketika pengembangan selesai, atur formulir dengan LocalizableAttribute (properti yang Dapat Dilokalkan di editor Properti) ke true, lalu serahkan file .resx untuk budaya default ke pelokalan pihak ketiga. File .resx ini berisi informasi tambahan yang Winres.exe gunakan untuk membuat ulang versi waktu desain dari formulir asli.

Catatan

Winres.exe tidak dapat digunakan untuk mengedit file sumber default. Winres.exe menafsirkan semua properti yang diubah sebagai properti yang dilokalkan dan menyimpannya ke file sumber budaya target.

Versi terakhir dari file sumber budaya akhirnya dapat digunakan untuk membuat versi aplikasi yang dilokalkan. Untuk informasi selengkapnya, lihat Sumber Daya di aplikasi .NET.

Winres.exe memiliki fitur dan kemampuan berikut:

Winres dapat beroperasi dalam Mode File Tunggal (SFM) atau mode File Visual Studio (VSFM). SFM adalah mode yang lebih lama tempat informasi lengkap tentang formulir dan kontennya disimpan ke file sumber. VSFM hanya menyimpan perubahan budaya dalam file sumber.
Jendela pelaporan kesalahan, ditambatkan ke kiri bawah jendela utama.
Hotkeys dapat diperiksa duplikatnya: dari menu Format, klik perintah Periksa HotKeys.

Kompatibilitas versi

Anda harus menggunakan versi Winres.exe yang dirilis dengan .NET Framework yang Anda gunakan. Tabel berikut mencantumkan versi yang kompatibel:

Visual Studio	.NET Framework	Winres.exe
Visual Studio .NET 2002	1,0	1.0
Visual Studio .NET 2003	1.1	1.1
Visual Studio 2005	2.0	2.0
Visual Studio 2008	3.0 dan 3.5	3.0 dan 3.5
Visual Studio 2010	4,0	4,0
Visual Studio 2017	4.6	4.6

Catatan

Meskipun VSFM memiliki keuntungan karena kompatibel dengan Visual Studio, karena hanya menyimpan nilai yang diubah dalam file sumber, Winres.exe mengharuskan induk dari file sumber saat ini berada di direktori yang sama. Misalnya, mengedit TestApp.de-DE.resources, bahasa Jerman dalam file sumber bahasa Jerman, memerlukan keberadaan file sumber default, TestApp.resx, dan mungkin file sumber netral budaya, TestApp.de.resources.

Contoh

Untuk melokalisasi file .resx atau .resources yang terkait dengan formulir

Untuk menjalankan Winres.exe, masukkan winres di prompt perintah pengembang.
Untuk membuka sumber daya default untuk formulir yang akan dilokalkan, pilih Buka File > dan navigasikan ke file untuk membukanya.

-atau-

Tentukan file yang akan dibuka pada baris perintah saat Anda memulai Winres.exe. Perintah berikut memulai Winres.exe dan memuat formulir yang terkait dengan TestApp.resx di Perancang Formulir.
```
winres TestApp.resx
```
Perintah berikut memulai Winres.exe dan memuat formulir yang terkait dengan TestApp.resources di Perancang Formulir.
```
winres TestApp.resources
```
Catatan

Jika formulir yang sumber dayanya yang Anda edit adalah formulir yang diwariskan, baik rakitan yang berisi formulir yang diwariskan dan rakitan yang berisi formulir yang diwarisi (turunan) harus didaftarkan di Singgahan Perakitan Global (GAC), atau harus berada di direktori yang sama sebagai WinRes.exe. Untuk informasi selengkapnya tentang memasang komponen .NET Framework ke GAC, lihat Singgahan Perakitan Global.
Pilih kontrol pada formulir dan ubah Text dan properti lainnya untuk mencerminkan budaya yang dilokalkan dan bahasanya. Pindahkan atau ubah ukuran kontrol seperlunya untuk mengakomodasi teks yang dilokalkan.
Untuk menyimpan versi file .resx atau .resources yang dilokalkan, klik ikon Simpan atau pilih Simpan File>. Alat ini menampilkan jendela Pilih Budaya.
Pilih budaya dan mode file yang sesuai lalu klik OK.

Alat ini menyimpan file menggunakan konvensi penamaan yang diharapkan runtime untuk file sumber daya yang dilokalkan. Misalnya, jika Anda melokalisasi TestApp.resources untuk bahasa Jerman di bahasa Jerman, alat menyimpan file sebagai TestApp.de-DE.resources. Jika Anda melokalisasi TestApp.resx untuk bahasa Jerman di bahasa Jerman, alat menyimpan file sebagai TestApp.de-DE.resx. Untuk informasi selengkapnya tentang konvensi penamaan sumber daya, lihat Mengemas dan Menyebarkan sumber daya. Untuk daftar nama budaya yang telah ditentukan sebelumnya yang digunakan oleh runtime, lihat CultureInfo kelas .

Bagikan melalui