Aracılığıyla paylaş

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

Winres.exeWindows 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 kaynak dağıtma hakkında bilgi için bkz. .NET uygulamalarında 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.

Uyarı

Güvenilmeyen dosyaları bu araçla açmayın. Dosya bir ikili dosyaysa, güvenli olmayan ikili seri durumdan çıkarma kullanılarak seri durumdan çıkarılır. Daha fazla bilgi için bkz. BinaryFormatter ve ilgili türlerin kullanımında seri durumdan çıkarma riskleri.

Sözdizimi

winres resourceFile
winres /?

Arguments

Argument Description
resourceFile Yerelleştirecek kaynak dosyası. Bu dosya, Visual Studio tasarımcısı tarafından oluşturulan bir Windows Forms formu .resx veya .resources dosyası olmalıdır. Winres.exe genel .resx veya .resources dosyalarını açamıyor.
Seçenek Description
/? Araç için komut söz dizimini ve seçeneklerini görüntüler.

Açıklamalar

Windows Forms projesindeki bir formdaki kullanıcı arabirimi öğelerinin durumu genellikle .resx uzantısına sahip XML tabanlı dosyalar veya .resources uzantısına sahip karşılık gelen derlenmiş ikili sürümler olan kaynak dosyalarında depolanır. Winres.exe, Visual Studio tasarım ortamının dışında her iki dosya türünün de sınırlı düzenlenmesini sağlayan bir araçtır. Özellikle, aşağıdaki düzenleme işlemi türlerine izin verir:

  • Nötr veya belirli bir kültür kaynak dosyası, formun veya denetimlerinin metin, boyut veya konum gibi kullanıcı arabirimi özelliklerini değiştirmek için 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ürle uyumlu olacak şekilde düzenlenir.

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

Winres.exe bir .resx dosyasını ilgili .resources dosyasına dönüştüremez; yerine Resgen.exe aracını kullanın. Resgen.exehakkında daha fazla bilgi için bkz. Resgen.exe (Kaynak Dosya Oluşturucu).

Winres.exe, kaynak koda erişmeden yalnızca kaynak dosyasından Windows Forms formunun tasarım zamanı sürümünü yeniden oluşturan grafik bir uygulamadır. Winres.exe, Visual Studio'nun Windows Forms Form Tasarımcısı'nı ve Properties penceresini barındırıyor. Bu özellikler, Windows Forms formu içeren bir .resources veya .resx dosyasının görsel olarak düzenlenmesini sağlar. 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ü çözemezse, yerelleştirilmiş .resx veya .resources dosyasında bir yer tutucu denetimi oluşturur. Yer tutucu denetimi, Windows Forms formunda taranmış pencere olarak görünür. Taranan pencerenin boyutu ve konumu, gerçek denetimin boyutuyla eşleşir. Yer tutucu denetimi için kullanılabilir tüm yerelleştirilebilir özellikler pencerede Properties görünür. Yer tutucu denetiminde yaptığınız tüm değişiklikler gerçek denetim için kaydedilir.

visual studio ile Winres.exe karşılaştırması

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

Visual Studio'nun avantajı, uygulamayı hem geliştirmek hem de yerelleştirmek için kullanabilmenizdir. Formu yerelleştirmek için, geliştirme tamamlandıktan sonra formun (düzenleyicideki Properties özelliği) olarak true ayarlayın ve özelliğini istenen hedef kültüre değiştirinLanguage.LocalizableLocalizableAttribute Ardından, dizeleri düzenleyin ve denetimlerin konumunu ve boyutunu hedef kültürün dizelerini barındıracak ş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 doğru dizin konumunda otomatik olarak bir uydu derlemesi 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ğundan, uygulama kodunun yerelleştirilecek formlardan daha temiz bir şekilde ayrılmasına olanak tanır ve bu da büyük projeleri yönetmek için daha pratiktir.

Winres.exe kullanma

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

Uyarı

Winres.exe varsayılan kaynak dosyasını düzenlemek için kullanılamaz. Winres.exe, değiştirilen tüm özellikleri yerelleştirilmiş özellikler olarak yorumlar ve bunları hedef kültür kaynak dosyasına kaydeder.

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ında kaynaklar.

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

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

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

  • Kısayol tuşları yinelenenler için denetlenebilir: Format Menüden 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:

Visual Studio .NET Çerçevesi 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 ve 3.5 3.0 ve 3.5
Visual Studio 2010 4,0 4,0
Visual Studio 2017 4.6 4.6

Uyarı

VSFM, Visual Studio ile uyumlu olma avantajına sahip olsa da, kaynak dosyasında yalnızca değiştirilen değerleri depoladığından Winres.exe geçerli kaynak dosyasının ana dosyalarının aynı dizinde bulunması gerekir. Örneğin, Almanya'daki bir Almanca kaynak dosyasını düzenlemek TestApp.de-DE.resourcesiçin varsayılan kaynak dosyasının TestApp.resxve büyük olasılıkla kültürden bağımsız kaynak dosyasının TestApp.de.resourcesbulunması gerekir.

Örnekler

Formla ilişkilendirilmiş bir .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 dosyaya gidip açın.

    -veya-

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

    winres TestApp.resx

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

    winres TestApp.resources

    Uyarı

    Kaynaklarını düzenlediğiniz form devralınan bir formsa, hem derleme devralınan formu içeriyordu hem de devralan (türetilmiş) formu içeren derleme Genel Bütünleştirilmiş Kod Önbelleği'ne (GAC) kayıtlı olmalı veya WinRes.exeile aynı dizinde bulunmalıdır. .NET Framework bileşenlerini GAC'ye 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ş metne uyum sağlamak için 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 simgeye Save 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çip 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 bakınız

  • Last updated on