Winres.exe (Windows Kaynak Yerelleştirme Düzenleyicisi)

Winres.exe Windows Kaynak Yerelleştirme Düzenleyicisi, yerelleştirme uzmanlarının formlar tarafından kullanılan Windows Forms kullanıcı arabirimi (UI) kaynaklarını yerelleştirmesine yardımcı olan bir görsel düzen aracıdır. Microsoft Visual Studio gibi bir görsel tasarım ortamı kullanarak Winres.exe giriş olarak kullanılan .resx veya .resources dosyalarını oluşturabilirsiniz. .NET Framework uygulamalarında kaynakları dağıtma hakkında bilgi için bkz. .NET uygulamalarındaki kaynaklar.

Winres.exe Visual Studio ile birlikte yüklenir. Aracı çalıştırmak için Visual Studio Geliştirici Komut İstemi'ni veya Visual Studio Geliştirici PowerShell'i kullanın.

Söz dizimi

winres resourceFile
winres /?

Bağımsız değişkenler

Açıklamalar

Windows Forms projesindeki bir formdaki kullanıcı arabirimi öğelerinin durumu genellikle .resx uzantılı XML tabanlı dosyalar veya .resources uzantısına sahip ilgili derlenmiş, ikili sürümler olan kaynak dosyalarında depolanır. Winres.exe, her iki dosya türünün Visual Studio tasarım ortamı dışında sınırlı şekilde düzenlenmesine olanak veren bir araçtır. Özellikle aşağıdaki türden düzenleme işlemlerine izin verir:

• Bir nötr veya belirli kültür kaynak dosyası, formun arabirim özelliklerini veya denetimlerini (metin, boyut veya konum gibi) değiştirecek şekilde düzenlenebilir.
• Nötr veya belirli kültür kaynak dosyaları varsayılan kaynak dosyasından oluşturulabilir.
• Bir kültür kaynak dosyası başka bir kültür kaynak dosyası olarak kaydedilebilir. Örneğin, İngilizce (ABD) kaynak dosyası Lehçe kaynak dosyası olarak kaydedilebilir. Genellikle yeni dosya daha sonra yeni kültür ile uyumlu olacak şekilde düzenlenir.

Ayrıca bkz . Yerelleştirme için Kaynakların Hiyerarşik Kuruluşu veya Yerelleştirme içinKaynakların Hiyerarşik Kuruluşu.

Winres.exe, bir .resx dosyasını karşılık gelen .resources dosyasına dönüştüremez; bunun yerine Resgen.exe aracını kullanmalısınız. Resgen.exe hakkında daha fazla bilgi için bkz. Resgen.exe (Kaynak Dosya Oluşturucu).

Winres.exe, kaynak koduna erişmeden bir Windows Forms formunun tasarım zamanı sürümünü yalnızca kaynak dosyasından yeniden oluşturan grafiksel bir uygulamadır. Winres.exe, Visual Studio'nun Windows Forms Form Tasarımcısı ve Özellikler penceresini barındırıyor. Bu özellikler, Windows Forms formu içeren bir .resources veya .resx dosyasının görsel olarak düzenlenmesine olanak verir. Yerelleştiriciler genellikle Winres.exe kullanarak denetim etiketlerini düzenler ve denetimlerin konumunu ve boyutunu hedef kültürün etiketlerini barındıracak şekilde ayarlar.

Winres.exe bir denetimin türünü çözümleyemezse, yerelleştirilmiş .resx veya .resources dosyasında bir yer tutucu denetimi oluşturur. Yer tutucu denetimi Windows Forms formunda taranmış bir pencere olarak görüntülenir. Taranmış pencerenin boyutu ve konumu gerçek denetiminkilerle aynıdır. Yer tutucu denetimi için kullanılabilir tüm yerelleştirilebilir özellikler Özellikler penceresinde görünür. Yer tutucu denetiminde yaptığınız tüm değişiklikler asıl denetim için kaydedilir.

Winres.exe ve Visual Studio

Genel olarak, bir uygulamanın Windows Forms formlarını yerelleştirmeye başlamadan önce, yerelleştirme aracı olarak Visual Studio'yu mu yoksa Winres.exe'yi mi kullanmak istediğinize karar vermelisiniz. Sürüm uyumluluğu, daha sonra açıklandığı gibi, bir araçtan diğerine geçiş yapmasını engelleyebilir.

Visual Studio'nun avantajı, bir uygulamayı hem geliştirmek hem de yerelleştirmek için kullanabilmenizdedir. Formu yerelleştirmek için, geliştirme tamamlandıktan sonra formun LocalizableAttribute (Özellikler düzenleyicisindeki Localizable özelliği) true olarak ayarlayın ve Language özelliğini istenen hedef kültürle değiştirin. Daha sonra, dizeleri düzenleyin ve denetimlerin konumu ile boyutunu hedef kültürün dizelerine uygun olacak şekilde ayarlayın. Yerelleştirilmiş .resx dosyasını kaydettiğinizde, Visual Studio dosyaya yalnızca yerelleştirilebilir özellikleri (hedef kültürde değiştirilen özellikler) yazar. Visual Studio, yerelleştirilmiş .resx dosyası için bir uydu derlemesini doğru dizin konumunda otomatik olarak oluşturur.

Visual Studio tümleşik bir geliştirme ve yerelleştirme ortamı sağlasa da, yerelleştirme üçüncü taraf yerelleştiriciler tarafından yapılırsa kullanılması önerilen araç Winres.exe. Winres.exe yalnızca bir yerelleştirme aracı olduğu için, bir uygulamanın kodu ile yerelleştirilecek formlar arasında daha net bir ayrım sağlar, ki bu da büyük projeleri yönetirken daha büyük bir kolaylık demektir.

Winres.exe'yi kullanma

Winres.exe kullanarak yerelleştirmek için, önce Visual Studio'daki Windows Forms Tasarımcısı gibi bir görsel tasarımcı kullanarak bir uygulama geliştirmeniz gerekir. Geliştirme tamamlandığında formun LocalizableAttribute (Özellikler düzenleyicisindeki Localizable özelliği) değerini olarak trueayarlayın ve ardından varsayılan kültür için .resx dosyasını üçüncü taraf bir yerelleştiriciye teslim edin. Bu .resx dosyası özgün formun tasarım zamanı sürümünü yeniden oluşturmak için Winres.exe'nin kullandığı ek bilgileri içerir.

Kültür kaynak dosyalarının son sürümleri son olarak uygulamanın yerelleştirilmiş sürümlerini oluşturmak için kullanılabilir. Daha fazla bilgi için bkz. .NET uygulamalarındaki kaynaklar.

Winres.exe aşağıdaki özelliklere ve özelliklere sahiptir:

• Winres Tek Dosya Modu'nda (SFM) veya Visual Studio Dosya Modu'nda (VSFM) çalışabilir. SFM, form ve içeriği hakkındaki tüm bilgilerin kaynak dosyada depolandığı eski moddur. VSFM kültürel değişiklikleri yalnızca kaynak dosyasında depolar.

• Ana pencerenin sol alt kısmına yerleştirilmiş bir hata raporlama penceresi.

• Kısayol tuşları yinelenenler için denetlenebilir: Biçim menüsünde Kısayol Tuşlarını Denetle komutuna tıklayın.

Sürüm uyumluluğu

Kullandığınız .NET Framework ile yayımlanan Winres.exe sürümünü kullanmanız gerekir. Aşağıdaki tabloda uyumlu sürümler listelenmektedir:

Örnekler

Bir formla ilişkili .resx veya .resources dosyasını yerelleştirmek için

1. Winres.exe çalıştırmak için geliştirici komut istemine girin winres .

2. Yerelleştirecek bir formun varsayılan kaynaklarını açmak için Dosya > Aç'ı seçin ve dosyayı açmak için dosyaya gidin.

   -veya-

   Winres.exe'yi başlattığınızda komut satırında açılacak dosyayı belirtin. Aşağıdaki komut Winres.exe başlar ve Form Tasarımcısı'nda ile TestApp.resx ilişkilendirilmiş formu yükler.

   winres TestApp.resx
   

   Aşağıdaki komut Winres.exe başlar ve Form Tasarımcısı'nda ile TestApp.resources ilişkilendirilmiş formu yükler.

   winres TestApp.resources
   

   Not

   Kaynaklarını düzenlediğiniz form devralınmış bir form ise, hem formun içindeki derleme hem de devralan (türetilmiş) formu içeren derleme Genel Derleme Önbelleği'ne (GAC) kaydettirilmeli veya WinRes.exe ile aynı dizinde bulunmalıdır. GAC'ye .NET Framework bileşenleri yükleme hakkında daha fazla bilgi için bkz. Genel Bütünleştirilmiş Kod Önbelleği.

3. Formdaki denetimleri seçin ve bunların Text ve diğer özelliklerini yerelleştirilmiş kültürü ve dilini yansıtacak şekilde değiştirin. Yerelleştirilmiş metnin sığmasını sağlayacak şekilde denetimleri gerektiği gibi taşıyın veya yeniden boyutlandırın.

4. .resx veya .resources dosyasının yerelleştirilmiş sürümünü kaydetmek için Kaydet simgesine tıklayın veya Dosya > Kaydet'i seçin. Araç Kültür Seç penceresini görüntüler.

5. Uygun kültürü ve dosya modunu seçin, ardından Tamam'a tıklayın.

   Araç, çalışma zamanının yerelleştirilmiş kaynak dosyaları için beklediği adlandırma kuralını kullanarak dosyayı kaydeder. Örneğin, Almanya'da Almanca için yerelleştirirseniz TestApp.resources , araç dosyayı olarak TestApp.de-DE.resourceskaydeder. Almanya'da Almanca için yerelleştirirseniz TestApp.resx , araç dosyayı olarak TestApp.de-DE.resxkaydeder. Kaynak adlandırma kuralları hakkında daha fazla bilgi için bkz. Kaynakları paketleme ve dağıtma. Çalışma zamanı tarafından kullanılan önceden tanımlanmış kültür adlarının listesi için sınıfına CultureInfo bakın.

Ayrıca bkz.

• LocalizableAttribute
• CultureInfo
• ResourceManager
• ResourceReader
• ResourceWriter
• Araçlar
• .NET uygulamalarındaki kaynaklar
• Genelleştirme ve yerelleştirme