Winres.exe (Editor Pelokalan Sumber Daya Windows)

Editor Pelokalan Sumber Daya Windows, Winres.exe, adalah alat tata letak visual yang membantu pakar pelokalan melokalisasi sumber daya antarmuka pengguna (UI) Windows Forms 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 diinstal dengan Visual Studio. Untuk menjalankan alat ini, gunakan Perintah Pengembang Visual Studio atau Visual Studio Developer PowerShell.

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.

Syntax

winres resourceFile
winres /?

Arguments

Argumen Description
resourceFile File sumber daya untuk dilokalkan. File ini harus berupa file .resx atau .resources formulir Windows forms yang dihasilkan oleh perancang Visual Studio. Winres.exe tidak dapat membuka file .resx atau .resources generik.
Option Description
/? Menampilkan sintaks perintah dan opsi untuk alat ini.

Komentar

Status elemen UI dari formulir dalam proyek Windows Forms 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 daya budaya netral atau tertentu dapat diedit untuk mengubah properti UI formulir atau kontrolnya, seperti teks, ukuran, atau posisinya.
  • File sumber daya budaya netral atau spesifik dapat dihasilkan dari file sumber daya default.
  • File sumber daya budaya dapat disimpan sebagai file sumber daya budaya lain. Misalnya, file sumber daya bahasa Inggris (A.S.) dapat disimpan sebagai file sumber daya Polandia. Biasanya file baru kemudian 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 Daya).

Winres.exe adalah aplikasi grafis yang membuat ulang versi waktu desain formulir Windows Forms hanya dari file sumber daya, tanpa memiliki akses ke kode sumber. Winres.exe menghosting Desainer dan Properties jendela Formulir Windows Visual Studio. Fitur-fitur ini memungkinkan pengeditan visual file .resources atau .resx yang berisi formulir Windows Forms. Biasanya, localizer 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, Winres.exe membuat kontrol tempat penampung dalam file .resx atau .resources yang dilokalkan. Kontrol tempat penampung muncul pada formulir Windows Forms sebagai jendela yang ditetaskan. Ukuran dan posisi jendela yang ditetaskan cocok dengan kontrol aktual. Semua properti yang dapat dilokalkan yang tersedia untuk kontrol tempat penampung muncul di Properties jendela. Setiap perubahan yang Anda buat pada kontrol tempat penampung disimpan untuk kontrol aktual.

Winres.exe versus Visual Studio

Secara umum, sebelum Anda mulai melokalisasi formulir Windows Forms 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 LocalizableAttribute (properti di Properties editor) ke true dan ubah propertinya Language ke budaya Localizable 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 berubah 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 direkomendasikan untuk digunakan jika pelokalan dilakukan oleh pelokalan pihak ketiga. Karena Winres.exe hanya alat pelokalan, alat ini memungkinkan pemisahan kode aplikasi yang lebih bersih 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 Desainer Formulir Windows di Visual Studio. Ketika pengembangan selesai, atur formulir LocalizableAttribute (properti di Properties editor) ke true, lalu serahkan file .resx untuk budaya default ke localizer Localizable pihak ketiga. File .resx ini berisi informasi tambahan yang Winres.exe gunakan untuk membuat ulang versi waktu desain formulir asli.

Nota

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

Versi akhir file sumber daya 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 warisan di mana informasi lengkap tentang formulir dan kontennya disimpan ke file sumber daya. VSFM hanya menyimpan perubahan budaya dalam file sumber daya.

  • Jendela pelaporan kesalahan, ditampung ke kiri bawah jendela utama.

  • Hotkey dapat diperiksa duplikatnya: dari Format menu, 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

Nota

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

Examples

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

  1. Untuk menjalankan Winres.exe, masukkan winres di prompt perintah pengembang.

  2. 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 dimulai Winres.exe dan memuat formulir yang terkait dengan TestApp.resx di Perancang Formulir.

    winres TestApp.resx

    Perintah berikut dimulai Winres.exe dan memuat formulir yang terkait dengan TestApp.resources di Perancang Formulir.

    winres TestApp.resources

    Nota

    Jika formulir yang sumber dayanya Anda edit adalah formulir yang diwariskan, rakitan berisi formulir yang diwariskan dan rakitan yang berisi formulir warisan (turunan) harus terdaftar di Global Assembly Cache (GAC), atau harus berada di direktori yang sama dengan WinRes.exe. Untuk informasi selengkapnya tentang menginstal komponen .NET Framework ke GAC, lihat Singgahan Perakitan Global.

  3. Pilih kontrol pada formulir dan ubah properti dan Text properti lainnya untuk mencerminkan budaya yang dilokalkan dan bahasanya. Memindahkan atau mengubah ukuran kontrol seperlunya untuk mengakomodasi teks yang dilokalkan.

  4. Untuk menyimpan versi file .resx atau .resources yang dilokalkan, klik Save ikon atau pilih Simpan File>. Alat ini menampilkan jendela Pilih Budaya .

  5. 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 Jerman, alat menyimpan file sebagai TestApp.de-DE.resources. Jika Anda melokalisasi TestApp.resx untuk bahasa Jerman di 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 .

Lihat juga

  • Last updated on