Projedeki referansları yönetme

Bir dış bileşene veya bağlı hizmete kod yazmadan önce projenizin buna bir başvuru içermesi gerekir. Başvuru, temel olarak Visual Studio'nın bileşeni veya hizmeti bulmak için ihtiyaç duyduğu bilgileri içeren bir proje dosyasındaki bir giriştir.

Başvuru ekleme yönteminiz, üzerinde çalıştığınız kodun proje türüne bağlıdır:

• Çözüm Gezgini'nde Bağımlılıklar düğümü görürseniz, sağ tıklama ile açılan bağlam menüsünden Proje Başvurusu Eklemeseçebilirsiniz.

  

  Ayrıca proje düğümüne sağ tıklayıp >Proje Başvurusu Ekleseçebilirsiniz.

• Çözüm Gezgini'nde Başvurular düğümü görürseniz, sağ tıklayarak açılan bağlam menüsünü kullanarak Başvuru Ekleseçebilirsiniz.

  Sağ tıklama bağlam menüsünden "Başvuru Ekle" seçeneğinin ekran görüntüsü

  Alternatif olarak, proje düğümüne sağ tıklayıp >Referans Ekleseçeneğini belirleyin.

  Daha fazla bilgi için bkz. Nasıl yapılır: Atıfları ekleme veya kaldırma.

Aşağıdaki bileşen ve hizmet türlerine başvuru ekleyebilirsiniz:

• .NET sınıf kitaplıkları veya derlemeleri

• UWP uygulamaları

• COM bileşenleri

• Aynı çözümdeki projelerin diğer derlemeleri veya sınıf kitaplıkları

• Paylaşılan projeler

• XML Web hizmetleri

UWP uygulama referansları

Evrensel Windows Platformu (UWP), Windows çalıştıran her cihaz için ortak bir uygulama platformu sağlar. UWP uygulaması oluşturmayı öğrenmek için bkz. Öğreticisi: Visual Studio'da XAML ve C# ile ilk Evrensel Windows Platformu uygulamanızı oluşturma.

Proje referansları

Evrensel Windows Platformu (UWP) projeleri, bu projelerin Windows 10 ve sonraki sürümlerde kullanım dışı bırakılmış API'leri kullanmaması koşuluyla çözümdeki diğer UWP projelerine veya Windows 8.1 projelerine veya ikili dosyalara başvuru oluşturabilir. Daha fazla bilgi için bkz. Windows Çalışma Zamanı 8'den UWP'ye taşıma.

Windows 8.1 projelerini Windows 10 ve sonraki sürümlere yeniden hedeflemeyi seçerseniz, Visual Studio projelerini taşımak, geçirmek ve yükseltmek için bölümüne bakın.

Eklenti SDK Referansları

Visual Basic, C#, C++ ve JavaScript Evrensel Windows Platformu (UWP) uygulamaları, Bu Uzantı SDK'ları Windows 10 ve sonraki sürümlerde kullanım dışı bırakılmış API'leri kullanmazsa, Windows 8.1'i hedefleyen Uzantı SDK'larına başvurabilir. UWP uygulamaları tarafından başvurulup başvurulamayacağını öğrenmek için Uzantı SDK'sı satıcı sitesine bakın.

Uygulamanız tarafından başvurulmakta olan Uzantı SDK'sının desteklenmediğini belirlerseniz aşağıdaki adımları gerçekleştirmeniz gerekir:

1. Hataya neden olan projenin adına bakın. Projenizin hedeflediği platform, proje adının yanındaki parantez içinde not edilir. Örneğin, MyProjectName (Windows 8.1), projenizin MyProjectName Windows 8.1 platform sürümünü hedeflediği anlamına gelir.

2. Desteklenmeyen Uzantı SDK'sının sahibi olan satıcının sitesine gidin ve Uzantı SDK'sının sürümünü projenizin hedeflendiği platformun sürümüyle uyumlu bağımlılıklarla yükleyin.

   Not

   Uzantı SDK'larının diğer Uzantı SDK'larına bağımlılıkları olup olmadığını öğrenmenin bir yolu, Başvuru Yöneticisi'ne bakmaktır. Visual Studio'yu yeniden başlatın, yeni bir C# UWP uygulama projesi oluşturun ve projeye sağ tıklayın ve Başvuru Ekleöğesini seçin. Windows sekmesine, ardından Uzantıları alt sekmesine gidin ve Uzantı SDK'sını seçin. Sağ bölmeye, Başvuru Yöneticisi'de bakın. Bağımlılıkları varsa, bunlar orada listelenir.

   Önemli

   Projeniz windows 10'u özel olarak hedefleiyorsa ve önceki adımda yüklenen Uzantı SDK'sı Microsoft Visual C++ Çalışma Zamanı Paketi'ne bağımlıysa, Windows 10 ile uyumlu Microsoft Visual C++ Çalışma Zamanı Paketi sürümü v14.0'dır ve Visual Studio ile birlikte yüklenir.

3. Önceki adımda yüklediğiniz Uzantı SDK'sının diğer Uzantı SDK'larına bağımlılıkları varsa, bağımlılıkların sahibi olan satıcıların sitelerine gidin ve ardından bu bağımlılıkların projenizin hedeflediği platformun sürümüyle uyumlu sürümlerini yükleyin.

4. Visual Studio'yu yeniden başlatın ve uygulamanızı açın.

5. Hatanın sebep olduğu projede Başvurular veya Bağımlılıklar düğümüne sağ tıklayın ve Başvuru Ekleöğesini seçin.

6. Windows sekmesini ve ardından Uzantıları alt sekmesini seçin, eski Uzantı SDK'larının onay kutularının işaretini kaldırın ve yeni Uzantı SDK'larının onay kutularını işaretleyin. 'i seçin, ardından Tamam.

Tasarım zamanında bir referans ekleyin

Projenizdeki bir derlemeye başvuru yaptığınızda Visual Studio, derlemeyi aşağıdaki konumlarda arar:

• Geçerli proje dizini. (Gözat sekmesini kullanarak bu derlemeleri bulabilirsiniz.)

• Aynı çözümdeki diğer proje dizinleri. (Bu derlemeleri Projeler sekmesinde bulabilirsiniz.)

Çalışma zamanında paylaşılan bileşenlere başvurular

Çalışma zamanında, bileşenler projenin çıkış yolunda veya Genel Bütünleştirilmiş Kod Önbelleği'nde (GAC) olmalıdır. Proje bu konumlardan birinde olmayan bir nesneye başvuru içeriyorsa, projeyi oluştururken başvuruyu projenin çıkış yoluna kopyalamanız gerekir. CopyLocal özelliği, bu kopyanın yapılması gerekip gerekmediğini gösterir. Değer Trueise, referans projeyi oluşturduğunuzda proje dizinine kopyalanır. Değer Falseise, başvuru kopyalanmaz.

GAC'de kayıtlı özel bir bileşene başvuru içeren bir uygulama dağıtırsanız, CopyLocal ayarı ne olursa olsun bileşen uygulamayla dağıtılmaz. Visual Studio'nun önceki sürümlerinde, derlemenin dağıtıldığından emin olmak için başvuruda CopyLocal özelliğini ayarlayabilirsiniz. Şimdi, derlemeyi \Bin klasörüne el ile eklemeniz gerekir. Bu eylem, tüm özel kodları inceleme altına alır ve böylece aşina olmadığınız özel kod yayımlama riskini azaltır.

Varsayılan olarak, derleme veya bileşen genel derleme önbelleğindeyse veya bir çerçeve bileşeniyse CopyLocal özelliği false olarak ayarlanır. Aksi takdirde, değeri trueolarak ayarlanır. Projeden projeye referanslar her zaman Trueolarak ayarlanır.

.NET'in farklı bir sürümünü hedefleyen bir projeye veya derlemeye başvurma

.NET'in farklı bir sürümünü hedefleyen projelere veya derlemelere başvuran uygulamalar oluşturabilirsiniz. .NET Framework 4.6'yı hedefleyen bir uygulama oluşturabilirsiniz; bu uygulama, .NET Framework 4.5'i hedefleyen bir derlemeye başvurur. .NET'in önceki bir sürümünü hedefleyen bir proje oluşturursanız, bu projede daha yeni bir sürümü hedefleyen bir projeye veya derlemeye başvuru ayarlayamazsınız.

Daha fazla bilgi için bkz. Framework hedeflemeye genel bakış.

Projeden projeye referanslar

Projeden projeye başvurular, derlemeler içeren projelere başvurulardır; Başvuru Yöneticisi iletişim kutusunun Projeler sekmesini kullanarak proje başvuruları eklersiniz. Visual Studio, projenin yolu verildiğinde bir derleme bulabilir.

Yığın oluşturan bir projeniz olduğunda, projeye referans vermeli ve dosya referansı kullanmaktan kaçınmalısınız. Projeden projeye başvurunun avantajı, derleme sistemindeki projeler arasında bir bağımlılık oluşturmasıdır. Bağımlı proje, referans alan projenin en son oluşturulduğu zamandan bu yana değişmişse oluşturulur. Dosya başvurusu derleme bağımlılığı oluşturmaz, bu nedenle bağımlı projeyi oluşturmadan başvuran projeyi derlemek mümkündür ve başvuru artık kullanılamaz hale gelebilir. (Başka bir ifadeyle, proje projenin daha önce oluşturulmuş bir sürümüne başvurabilir.) Bu, kutusu dizininde tek bir DLL'nin birkaç sürümünün gerekli olmasına neden olabilir ve bu mümkün değildir. Bu çakışma oluştuğunda, "Uyarı: 'project' projesindeki 'file' bağımlılığı 'file' başvurusunun üzerine yazılacağından çalıştırma dizinine kopyalanamaz" gibi bir ileti görüntülenir. Daha fazla bilgi için bkz. Bozuk başvuru sorunlarını giderme ve Nasıl yapılır: proje bağımlılıklarını oluşturma ve kaldırma.

Paylaşılan proje başvuruları

Diğer proje türlerinin çoğundan farklı olarak, paylaşılan proje ikili çıktısı bulunmaz. Bunun yerine kod, referans veren her projede derlenir. Paylaşılan Projeler, birçok farklı uygulama projesi tarafından başvurulan ortak kod yazmanızı sağlar. Kod, başvuran her projenin bir parçası olarak derlenmiş ve platforma özgü işlevleri paylaşılan kod tabanına eklemeye yardımcı olacak derleyici yönergeleri içerebilir. Başvuru Yöneticisi iletişim kutusunun Paylaşılan Projeler sekmesinde paylaşılan projeye başvuru ekleyin.

Dosya referansları

Dosya başvuruları, Visual Studio projesi bağlamı dışındaki derlemelere doğrudan başvurulardır. Bunları, Başvuru Yöneticisi iletişim kutusunun Gözat sekmesini kullanarak oluşturursunuz. Sadece bir derleme veya bileşeniniz olup da çıktısını oluşturan proje yoksa dosya başvurusu kullanın.

İlgili içerik

• Bozuk referansları sorunlarını çözme
• Nasıl Yapılır: Referans Ekleme veya Kaldırma