Uygulama kaynaklarını yönetme
Kaynak dosyaları, bir uygulamanın parçası olan ancak derlenmeyen dosyalardır, örneğin simge dosyaları veya ses dosyaları. Bu dosyalar derleme işleminin bir parçası olmadığından, ikili dosyalarınızı yeniden derlemek zorunda kalmadan bunları değiştirebilirsiniz. Uygulamanızı yerelleştirmeyi planlıyorsanız, uygulamanızı yerelleştirirken değiştirilmesi gereken tüm dizeler ve diğer kaynaklar için kaynak dosyalarını kullanmanız gerekir.
Dikkat
Dosyalardaki .resx kaynaklar, güvenli olmayan kullanılarak BinaryFormatterseri hale getirilebilir. Derleme işleminize yalnızca .resx güvendiğiniz dosyaları ekleyin.
.NET uygulamalarındaki kaynaklar hakkında daha fazla bilgi için bkz . .NET uygulamalarında kaynaklar.
Kaynaklarla çalışma
Yönetilen kod projesinde proje özellikleri penceresini açın. Özellikler penceresini aşağıdakilerden birini kullanarak açabilirsiniz:
- Çözüm Gezgini proje düğümüne sağ tıklayıp Özellikler'i seçme
- Ctrl+Q arama kutusuna proje özelliklerini yazma
- Çözüm Gezgini'de Alt+Enter tuşuna basma
Kaynaklar sekmesini seçin. Projeniz henüz bir .resx dosyası içermiyorsa, farklı kaynak türlerini ekleyip silebilir ve mevcut kaynakları değiştirebilirsiniz.
Visual Studio 2022 ve sonraki sürümlerde Kaynak Gezgini geliştirmeleri
Visual Studio 2022 sürüm 17.11'den başlayarak kaynak gezgini önemli ölçüde geliştirilmiştir. Bkz . Yenilenmiş Visual Studio Kaynak Gezgini'ne Giriş.
Yeni Kaynak Gezgini'ni kullanmak için bir veya daha fazla kaynak dosyası (.resx) içeren bir .NET projeniz olması gerekir. Kaynak Gezgini'ni açmak için Çözüm Gezgini herhangi bir kaynak dosyasına sağ tıklayın ve Kaynak Gezgini ile>Aç'ı seçin. Alternatif olarak, Ctrl+Alt+R klavye kısayolunu da kullanabilirsiniz.
Yeni Kaynak Gezgini'ni açtığınızda, sol tarafta her dosyanın yerel ayarlarıyla birlikte depoladığınız tüm kaynaklara genel bir bakış görürsünüz. Veri kılavuzunda hangi yerel ayarların görünür olduğunu yapılandırabilirsiniz. Bu arabirim, çevirileri yan yana karşılaştırmanıza ve yerinde düzenlemenize olanak tanır.
Kaynak dizelerini arama
Kılavuzun sol üst kısmında, arama kutusunu kullanarak tüm kaynak dosyalarınızda arama metni oluşturabilirsiniz. Kaynak aramak için araç çubuğundaki arama kutusuna yazın ve Enter tuşuna basın. Veri kılavuzu yalnızca sorgunuzla eşleşen kaynakları kendi adlarında, değerlerinde veya açıklamalarında gösterir. Kısmi eşleşmeler gerçekleştirmek için joker karakterler (*) ve tam eşleşmeleri gerçekleştirmek için tırnak işaretleri (") kullanabilirsiniz.
Kaynağın belirli çevirilerine açıklama ekleme
Açıklamalar, bir dizenin anlamı, kullanımı veya tonu gibi bir kaynak için daha fazla bilgi veya bağlam sağlamanın kullanışlı bir yoludur. Kaynak Gezgini'nde, bir kaynağın her çevirisine açıklama ekleyebilir ve tümünü veri kılavuzunda tek seferde görüntüleyebilirsiniz.
Kaynağa açıklama eklemek için, açıklama eklemek istediğiniz çeviriye karşılık gelen hücreyi seçin ve araç çubuğundaki Açıklamayı Düzenle düğmesine tıklayın veya Shift Enter tuşuna+ basın. Hücrenin altında açıklama kutusu görüntülenir ve burada açıklamanızı yazabilirsiniz. Açıklamayı kaydetmek için Enter tuşuna veya atmak için Esc tuşuna basın.
Açıklama kutusuna tıklayarak veya aynı klavye kısayolunu kullanarak mevcut açıklamaları düzenleyebilir veya silebilirsiniz. Bir kaynağın tüm açıklamalarını görüntülemek için, açıklama içeren her hücrenin köşesindeki küçük üçgen simgesini arayın. Açıklama metnini içeren bir araç ipucu görmek için simgenin üzerine gelebilir veya açıklama kutusunu açmak için üzerine tıklayabilirsiniz.
Açıklamalar, kaynak dosyalarının birden çok kullanıcısı tarafından kullanılabilir. Çevirici, geliştirici veya kaynak yöneticisi, çevirilerin yanı sıra notlar, sorular, açıklamalar veya uyarılar bırakabilir. Her hücrenin köşesindeki küçük bir simge açıklamanın varlığını gösterir.
Kaynakları filtreleme
Kaynakları filtrelemek için araç çubuğundaki filtre simgesine tıklayın ve uygulamak istediğiniz ölçütleri seçin. Kaynakları ada, değere, açıklamaya, türe veya dosyaya göre filtreleyebilirsiniz.
| Filtre | Açıklama |
|---|---|
| Ad | Yalnızca belirli bir ada veya ön eke sahip kaynakları gösterin. |
| Değer | Yalnızca belirli bir değere sahip olan veya belirli bir dize içeren kaynakları gösterin. |
| Yorum | Yalnızca açıklaması olan veya açıklamalarında belirli bir dize içeren kaynakları gösterin. |
| Tür | Yalnızca dize, görüntü veya simge gibi belirli bir türe sahip kaynakları gösterin. |
| Dosya | Yalnızca belirli bir dosyaya veya kültüre ait kaynakları gösterin. |
Sonuçlarınızı daraltmak ve Filtreyi Temizle düğmesine tıklayarak bunları temizlemek için birden çok filtreyi birleştirebilirsiniz.
Doğrulama ve uyarılar
Yer tutucular, çalışma zamanında , veya {name}gibi {0}{1}dinamik değerlerle değiştirilen özel belirteçlerdir. Kaynaklarınızda yer tutucular kullanıyorsanız, tüm yerelleştirmelerde tutarlı olduklarından emin olmanız gerekir, aksi takdirde uygulamanızda hatalar veya beklenmeyen davranışlar görebilirsiniz.
Yeni Kaynak Gezgini her kaynak için yer tutucuları otomatik olarak doğrular ve varsayılan kültür ile diğer yerelleştirmeler arasında uyuşmazlık varsa bir uyarı simgesi gösterir. Örneğin, kaynağın varsayılan değeri "Hello, {name}!" ve İspanyolca değeri "Hola, {nombre}!" ise, yer tutucu adının farklı olduğunu gösteren bir uyarı simgesi görürsünüz. Uyuşmazlığın ayrıntılarını içeren bir araç ipucu görmek için simgenin üzerine gelebilir ve düzeltmek için üzerine tıklayabilirsiniz.
Eksik çeviriler, uygulamanızın kullanıcı deneyimini etkileyebilecek bir diğer yaygın sorundur. Belirli bir kültürdeki bir kaynak için çeviri sağlamazsanız, uygulama varsayılan kültüre geri döner ve bu da bazı kullanıcılar için uygun veya istenen bir durum olmayabilir. Kaynak Gezgini, belirli bir kültürdeki bir kaynak için değer yoksa bir uyarı simgesi göstererek bu sorunu önlemenize yardımcı olur. Örneğin, Fransızca kültürü için varsayılan değeri File olan ve değeri olmayan bir kaynağınız varsa>, çevirinin eksik olduğunu gösteren bir uyarı simgesi görürsünüz. Değer yok iletisini içeren bir araç ipucu görmek için simgenin üzerine gelebilir ve bunu seçerek bir değer ekleyebilirsiniz.
Özelleştirme seçenekleri
Visual Studio 2022 ve sonraki sürümlerde Kaynak Gezgini, görme engelli veya engelli geliştiricilerin daha erişilebilir olmasını sağlamak için ekran okuyucular ve yardımcı teknolojiyle uyumludur. Veri kılavuzunda gezinmek, değerleri ve açıklamaları düzenlemek ve yaygın eylemler gerçekleştirmek için klavye kısayollarını kullanabilirsiniz. Ayrıca ekran okuyucusunu kullanarak her hücrenin içeriğini ve araç ipuçlarını ve uyarıları okuyabilirsiniz.
Yakınlaştırma düzeyini ayarlamak için araç çubuğundaki yakınlaştırma kaydırıcısını veya yakınlaştırmak veya uzaklaştırmak için Ctrl+= ve Ctrl-+ klavye kısayollarını kullanın. Yakınlaştırma düzeyini varsayılana sıfırlamak için Ctrl+0 kullanın.
Kaynak Gezgini teması Visual Studio ortamının geri kalanıyla tutarlıdır. Açık, koyu veya mavi temalar arasında seçim yapabilirsiniz ve Kaynak Gezgini buna göre uyarlanır. Araç>Seçenekleri>Ortam>Yazı Tipleri ve Renkler iletişim kutusunu kullanarak veri kılavuzunun yazı tipini ve renklerini de değiştirebilirsiniz.
Diğer proje türlerindeki kaynaklar
Kaynaklar .NET projelerinde diğer proje türlerinden farklı yönetilir. Kaynaklar hakkında daha fazla bilgi için:
- Evrensel Windows Platformu (UWP) uygulamaları, bkz.Uygulama kaynakları ve Kaynak Yönetim Sistemi
- C++/CLI (yönetilen) projeleri, bkz . Masaüstü Uygulamalarında Kaynaklar
- C++ projeleri, bkz . Kaynak dosyalarıyla çalışma ve Nasıl yapılır: Kaynak oluşturma
- Projelerinize dahil edilen kaynak dosyalarını görüntülemek için Kaynak Görünümü penceresini (Diğer Windows>Kaynak Görünümünü Görüntüle>) kullanın.
Destek seçenekleri
Uygulama kaynaklarını yönetmeyle ilgili bir sorunla karşılaşırsanız bkz . Kaynak Düzenleyicisi'nde hataları giderme.