Uygulama kaynaklarını yönetme

2025-06-12

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

.resx dosyalarındaki kaynaklar, BinaryFormattergüvenli olmayan kullanılarak seri hale getirilebilir. Derleme işleminize yalnızca güvendiğiniz .resx 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'nde proje düğümüne sağ tıklayıp Özellikler'i seçin
Ctrl+ arama kutusuna proje özelliklerini yazma
Çözüm Gezgini'nde+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'nde herhangi bir kaynak dosyasına sağ tıklayın veKaynak Gezgini> 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 tablosunda hangi yerellerin 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öşesinde, arama kutusunu kullanarak tüm kaynak dosyalarınızda metin araması yapabilirsiniz. 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+ 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. Yorum metnini içeren bir araç ipucu görmek için simgenin üzerine gelerek veya yorum kutusunu açmak için tıklayarak işlem yapabilirsiniz.

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
İsim	Yalnızca belirli bir isim veya ön ek taşıyan 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 {0}, {1} veya {name} gibi dinamik değerlerle değiştirilen özel işaretlerdir. 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 > olan ve değeri olmayan bir kaynağınız varsaFile, ç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. Anlatıcıyı kullanarak her hücrenin içeriğini, 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.