Proje Başvurularını Yönetme

Makale
06/10/2015

Bir dış bileşene karşı kodu yazmadan önce projeniz ilk olarak bu bileşene bir başvuru içermelidir.Aşağıdaki bileşen türlerine başvuruda bulunabilirsiniz:

Windows Mağazası uygulama başvuruları
.NET Framework sınıf kitaplıkları veya derlemeleri
COM bileşenleri
Aynı çözüm içindeki projelerin diğer derlemeleri veya sınıf kitaplıkları
XML Web Hizmetleri

XML Web hizmeti başvuruları hakkında daha fazla bilgi için bkz. Web References.

Windows Mağazası Uygulama Başvuruları

Proje Başvuruları

Windows 8 öğesini hedefleyen Windows Mağazası projeleri, Windows Mağazası projelerine veya Windows 8,1 öğesini hedefleyen ikili dosyalara bağlı olamaz.

Uygulamanızdaki herhangi bir proje, Windows 8,1 öğesini hedefliyorsa ve uygulamanız bir C++ Windows Mağazası projesinden oluşuyorsa, aşağıdaki adımları gerçekleştirmeniz gerekir:

Uygulamalarınızdaki tüm projelerinizi Windows 8,1 yeniden yönlendirin.Uygulamanızdaki her projeye sağ tıklatın ve Windows 8 için yeniden hedeflendir komutunu seçin ve ardından Proje ve Çözüm Değişikliklerini Gözden Geçir iletişim kutusundaki Tamam düğmesine tıklayın.
C++ Windows Mağazası projesine bağlı olan her Visual Basic, Visual C# ve JavaScript projeye sağ tıklatın, Başvuru Ekle'yi seçin, Windows sekmesine gidin, sonra da Uzantılar alt sekmesine, Microsoft Visual C++ Çalışma Zamanı Paketi v11.0 onay kutusunu temizleyin ve Microsoft Visual C++ Çalışma Zamanı Paketi v12.0'ı işaretleyin ve Tamam'a tıklayın.

Projeler, Windows 8,1'de kullanımdan kaldırılan API'leri kullanmıyorsa, Windows 8,1'i hedefleyen Visual Basic, C# ve JavaScript Windows Store projeleri, Windows 8'i hedefleyen Visual Basic ve C# Windows Store projelerine başvurabilir.Bkz. Windows 8 uygulamalarını Windows 8.1 önizlemeye geçirme; Windows 8 Windows Mağazası hedefleyen projelerin Windows 8,1 projesinden başvurulduğunda beklendiği gibi davranmaya devam edip etmediğini bulmak için.

Uzantı SDK Başvuruları

Çalışma zamanı sorunlarına neden olacağından, Windows 8,1'i hedefleyen Visual Basic, C#, C++ ve JavaScript Windows Store projeleri, Microsoft Visual C++ Runtime Package v11.0'a bağlı olan Uzantı SDK'lerine başvuramaz.Yeni bir C# Windows Store projesi oluşturup projeyi sağ tıklattıktan sonra Başvuru Ekle'yi seçip Windows sekmesine ve Uzantılar alt sekmesine gidip Uzantı SDK'sini seçip Başvuru Yöneticisi'ndeki sağ bölmede bağımlılık olarak Microsoft.VCLibs, sürüm = 11.0 öğesinin listelenip listelenmediğine bakarak Uzantı SDK'sinin Microsoft Visual C++ Runtime Package v11.0'a bağlı olup olmadığını öğrenebilirsiniz.

Uzantı SDK'leri, Windows 8,1'de kullanımdan kaldırılan API'leri kullanmıyorsa, Windows 8,1'i hedefleyen Visual Basic, C# ve JavaScript Windows Store projeleri, Microsoft Visual C++ Runtime Package v11.0'a bağlı olmayan Uzantı SDK'lerine başvurabilir.Lütfen Windows 8,1 hedefleyen Windows Mağazası projeleri tarafından başvurulabilir olup olmadığını bulmak için Uzantı SDK satıcısı sitesini gözden geçirin.

Uygulamanızın başvurduğu Uzantı SDK'sinin desteklenmediğini belirlerseniz, aşağıdaki adımları gerçekleştirmeniz gerekir:

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

Desteklenmeyen Uzantı SDK'sine sahip satıcının sitesine gidin ve projenizin hedeflediği platformun sürümü ile uyumlu olan bağımlılıkları içeren Uzantı SDK'sinin sürümünü yükleyin.

[!NOT]

Uzantı SDK'nın diğer uzantı SDK'lara bağımlı olup olmadığını bulmanın bir yolu, Visual Studio'yu yeniden başlatmak, yeni bir C# Windows Mağazası projesi oluşturmak, proje üzerinde sağ tıklamak ve Başvuru Ekle'yi seçip Pencereler sekmesine gitmek ve Uzantılar alt sekmesine gidip, Uzantı SDK'yı seçmek ve Referans Yöneticisi'nde sağ bölmeye bakmaktır.Bağımlılıkları varsa, burada listelenir.

Önemli
Projeniz Windows 8,1 hedefliyorsa ve önceki adımda yüklenen Uzantı SDK'de Microsoft Visual C++ Çalışma Zamanı Paketinde bağımlılık vardır; Microsoft Visual C++ Çalışma Zamanı sürümü Windows 8.1 v12.0 ile uyumludur ve Visual Studio 2013 ile yüklenmiştir.

Önceki adımda yüklediğimiz Uzantı SDK'si, başka Uzantı SDK'lerinde bağımlılıklar içeriyorsa, bağımlılıklara sahip olan satıcının sitelerine gidin ve projenizin hedeflediği platformun sürümü ile uyumlu olan bu bağımlılıkların sürümlerini yükleyin.
Visual Studio'yu yeniden başlatın ve uygulamanızı açın.
Hataya neden olan proje üzerinde sağ tıklatın ve (Visual Basic, C# veya JavaScript projelerinde) Başvuru Ekle veya (C++ projelerinde) Başvurular öğesini seçin.C++ projeleri için Yeni Başvuru Ekle düğmesini tıklatın.
Önce Windows sekmesini ve sonra Uzantılar alt sekmesini tıklatın, ardında eski Uzantı SDK'lerinin onay kutularının işaretini kaldırın ve yeni Uzantı SDK'lerinin onay kutularını işaretleyin.Tamam düğmesini tıklatın.

Tasarım Zamanında Başvuru Ekleme

Tasarım zamanında bir veya birden çok referans eklemek için, hangi tür proje oluşturmakta olduğunuza bağlı olarak, Başvuru Yöneticisi iletişim kutusunu veya Başvuru Ekle iletişim kutusunu kullanırsınız.Tüm Windows Mağazası uygulamaları ve diğer proje türlerinin çoğu için Başvuru Yöneticisi iletişim kutusunu kullanırsınız.Daha fazla bilgi için bkz. Nasıl Yapılır: Başvuru Yöneticisi'ni Kullanarak Başvuru Ekleme veya Kaldırma.Birkaç başka proje türü, Başvuru Ekle iletişim kutusunu destekler.Daha fazla bilgi için bkz. Nasıl Yapılır: Başvuru Ekle İletişim Kutusunu Kullanarak Başvurular Ekleme veya Kaldırma.

Listelenmeyen derlemelere gözatmak için Başvuru Ekle iletişim kutusunu kullanabilirsiniz.Çalışma zamanı ortamının kesin bir parçası olduğu için Genel Derleme Önbelleği'ten (GAC) başvurular ekleyemezsiniz.

Projenizde bir derlemeye bir başvuruda bulunduğunuzda, Visual Studio derlemeyi aşağıdaki yerlerde arar:

Geçerli proje dizini. (Gözat sekmesini kullanarak bu derlemeleri bulabilirsiniz.)
Aynı çözüm içindeki diğer proje dizinleri. (Projeler sekmesinde bu derlemeleri bulabilirsiniz.)

Tasarım zamanında nasıl başvurular ekleneceği hakkında daha fazla bilgi için bkz. Nasıl Yapılır: Başvuru Ekle İletişim Kutusunu Kullanarak Başvurular Ekleme veya Kaldırma.

[!NOT]

Tüm projeler, mscorlib öğesine dolaylı bir başvuru içerir.Visual Basic projeleri, Microsoft.VisualBasic öğesine dolaylı bir başvuru içerir.

Başvurular listesinden System.Core kaldırılsa da Visual Studio'daki tüm projeler, System.Core öğesine dolaylı bir başvuru içerir.

Çalışma Zamanında Paylaşılan Bileşenlere Başvurular

Çalışma zamanında bileşenler projenin çıkış yolunda veya Genel Derleme Önbelleği (GAC) içinde olmalıdır.Proje, bu konumlardan birinde olmayan bir nesneye başvuru içeriyorsa, projeyi oluşturduğunuzda projenin çıktı yoluna başvuruyu kopyalamanız gerekir.CopyLocal özelliği, bu kopyanın çıkarılmak zorunda olup olmadığını gösterir.Değer True ise projenizi oluşturduğunuzda proje dizinine başvuru kopyalanır.Değer False ise başvuru kopyalanmaz.

GAC'ye kayıtlı bir özel bileşene başvuru içeren bir uygulama dağıtırsanız, CopyLocal ayarına bakılmaksızın uygulama ile birlikte bileşen dağıtılmaz.Önceki Visual Studio sürümlerinde, derlemenin dağıtılmasını sağlamak için başvuruya CopyLocal özelliğini ayarlayabiliyordunuz.Şimdi, derlemeyi \Bin klasörüne el ile eklemelisiniz.Bu özel kod ile size tanıdık olmayan yayımlama riskini azaltarak, scrutiny altında tüm özel kodları yerleştirir.

Derleme veya bileşen, genel derleme önbelleğindeyse veya bir çerçeve bileşeniyse varsayılan olarak CopyLocal özelliği False olarak ayarlanır.Aksi takdirde, değeri Doğru olarak ayarlayın.Projeden projeye başvurular her zaman doğru olarak ayarlanmıştır.

Bir Proje ya da Farklı bir .NET Framework Sürümünü Hedefleyen Derlemeye Başvuru

.NET Framework'ün farklı bir sürümünü hedefleyen projelere veya derlemelere başvuran uygulamalar oluşturabilirsiniz.Örneğin, .NET Framework 2,0 öğesini hedefleyen bir derlemeye başvuran .NET Framework 4 İstemci Profili öğesini hedefleyen bir uygulama oluşturabilirsiniz.Önceki bir .NET Framework sürümünü hedefleyen bir proje oluşturursanız, bu projedeki bir başvuruyu, .NET Framework 4 İstemci Profili veya .NET Framework 4 sürümünü hedefleyen bir projeye ya da derlemeye ayarlayamazsınız.

Daha fazla bilgi için bkz. Belirli Bir .NET Framework Sürümünü veya Profilini Hedefleme.

Projeden Projeye Başvurular ve Dosya Başvuruları

Dosya başvuruları, derlemelere yönelik doğrudan başvurulardır; Başvuru Ekle iletişim kutusunun Gözat sekmesini kullanarak bunları oluşturursunuz.Projeden projeye başvurular, derlemeler içeren projelere başvurulardır; Başvuru Ekle iletişim kutusu Proje sekmesini kullanarak bunları oluşturursunuz.

Proje- proje başvurusunun avantajı yapı sistemindeki projeler arasında bağımlılık oluşturmasıdır.Bu nedenle, başvurulan projenin son oluşturulmasından bu yana bağımlı proje değişmiş ise oluşturulacaktır.Dosya başvurusu bir yapı bağımlılığı oluşturmaz, bu nedenle bağımlı proje oluşturmadan başvuran projeyi oluşturmak olasıdır ve başvuru geçersiz kılınabilir. (Diğer bir deyişle, proje, projenin önceden oluşturulmuş bir sürümüne başvuruda bulunabilir.) Bu, tek bir DLL'nin çeşitli sürümlerinin olanaksız bir şekilde bin dizininde gerekli olmasıyla sonuçlanabilir.Bu çakışma oluştuğunda, Uyarı: 'Dosya' başvurusunun üzerine yazacağından 'proje' projesindeki 'dosya' bağımlılığı çalıştırma dizinine kopyalanamıyor. gibi bir ileti görürsünüz.

Aynı çözümdeki başka bir projenin çıktılarına dosya başvuruları eklemekten kaçının, aksi takdirde derleme hataları olabilir.Bunun yerine, Başvuru Ekle iletişim kutusunun Projeler sekmesini, aynı çözüm içinde proje proje başvurular oluşturmak için kullanın.Bu projelerinizde oluşturduğunuz sınıf kitaplıklarının daha iyi yönetimibi sağlayarak ekip geliştirmeyi kolaylaştırır.Daha fazla bilgi için, bkz. Bozuk Başvurularda Sorun Giderme ve Nasıl Yapılır: Proje Bağımlılıklarını Oluşturma ve Kaldırma.

[!NOT]

Bir projenin .NET Framework hedef sürümü, sürüm 4.5 ise ve diğer projenin hedef sürümü, sürüm 2, 3, 3.5 veya 4.0 ise bir proje başvurusu yerine dosya başvurusu oluşturulur.

Web başvuruları

Ayrıca Web Başvurusu Ekle iletişim kutusunu kullanarak Web başvuruları ekleyebilirsiniz.Daha fazla bilgi için bkz. How to: Add and Remove Web References.

Ayrıca bkz.

Share via