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.

Kaynakların kılavuz görünümünün ekran görüntüsü.

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.

Kaynak Gezgini'ndeki açıklama kullanıcı arabiriminin ekran görüntüsü.

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.

Eksik bir çeviri algılandığında Kaynak Gezgini'nin ekran görüntüsü.

Ö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:

Destek seçenekleri

Uygulama kaynaklarını yönetmeyle ilgili bir sorunla karşılaşırsanız bkz . Kaynak Düzenleyicisi'nde hataları giderme.