Office birincil birlikte çalışma derlemeleri

Makale
06/19/2023

Bir Office projesindeki Microsoft Office uygulaması'nin özelliklerini kullanmak için uygulama için birincil birlikte çalışma derlemesini (PIA) kullanmanız gerekir. PIA, yönetilen kodun Microsoft Office uygulaması lication'ın COM tabanlı nesne modeliyle etkileşim kurmasını sağlar.

Not

Office deneyimini birden çok platformda genişleten çözümler geliştirmek mi ilginizi çekiyor? Yeni Office Eklentileri modeline göz atın. Office Eklentileri, VSTO Eklentileri ve çözümleriyle karşılaştırıldığında küçük bir ayak izine sahiptir ve HTML5, JavaScript, CSS3 ve XML gibi neredeyse tüm web programlama teknolojisini kullanarak bunları oluşturabilirsiniz.

Yeni bir Office projesi oluşturduğunuzda, Visual Studio projeyi oluşturmak için gereken PIA'lara başvurular ekler. Bazı senaryolarda, diğer PIA'lara başvuru eklemeniz gerekebilir (örneğin, Microsoft Office Excel için bir projede Microsoft Office Word'ün bir özelliğini kullanabilirsiniz).

Bu makalede, Office projelerinde Microsoft Office PIA'larını kullanmanın aşağıdaki yönleri açıklanmaktadır:

Projeleri derlemek ve çalıştırmak için birincil birlikte çalışma derlemelerini ayırma
Tek bir projede birden çok Microsoft Office uygulaması lication özelliğini kullanma
Microsoft Office uygulaması lications için birincil birlikte çalışma derlemelerinin tam listesi

Birincil birlikte çalışma derlemeleri hakkında daha fazla bilgi için bkz . Birincil birlikte çalışma derlemeleri.

Projeleri derlemek ve çalıştırmak için birincil birlikte çalışma derlemelerini ayırma

Visual Studio, geliştirme bilgisayarında farklı PIA kümelerini kullanır. Bu farklı derleme kümeleri aşağıdaki konumlardadır:

Program files dizinindeki bir klasör

Bu derleme kümesi, kod yazarken ve proje oluştururken kullanılır. Visual Studio bu derlemeleri otomatik olarak yükler.
Genel derleme önbelleği

Bu derleme kümesi, projeleri çalıştırdığınız veya hatalarını ayıkladığınız durumlar gibi bazı geliştirme görevleri sırasında kullanılır. Visual Studio bu derlemeleri yüklemez ve kaydetmez; Bunu kendin yapmalısın.

Program dosyaları dizinindeki birincil birlikte çalışma derlemeleri

PIA'lar, Visual Studio'yu yüklerken dosya sistemindeki genel derleme önbelleğinin dışındaki bir konuma otomatik olarak eklenir. Yeni bir proje oluşturduğunuzda Visual Studio, piA'ların bu kopyalarına başvurularını projenize otomatik olarak ekler. Visual Studio, projenizi geliştirip oluştururken tür başvurularını çözümlemek için genel derleme önbelleğindeki derlemeler yerine PIA'ların bu kopyalarını kullanır.

PIA'ların farklı sürümleri genel derleme önbelleğine kaydedildiğinde, çeşitli geliştirme sorunlarıyla karşılaşabilirsiniz. Eklenen PIA kopyaları bu tür sorunlardan kaçınmanıza yardımcı olur.

Visual Studio 2017 ve üzeri için, PIA'ların bu kopyaları geliştirme bilgisayarında aşağıdaki paylaşılan konumlara yüklenir:

%ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\
(veya %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ 64 bit işletim sistemlerinde)

Not

Visual Studio'nun eski sürümleri için bu PIA'lar, Visual Studio'nun söz konusu sürümünün klasörünün %ProgramFiles% altındaki Office\PIA için Visual Studio Araçları klasörüne yüklenir. Örneğin: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Genel derleme önbelleğindeki birincil birlikte çalışma derlemeleri

Belirli geliştirme görevlerini gerçekleştirmek için PIA'ların yüklenmesi ve geliştirme bilgisayarındaki genel derleme önbelleğine kaydedilmesi gerekir. Genellikle, geliştirme bilgisayarına Office yüklediğinizde PIA'lar otomatik olarak yüklenir. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.

Office çözümlerini çalıştırmak için son kullanıcı bilgisayarlarında Office PIA'ları gerekli değildir. Daha fazla bilgi için bkz . Office çözümleri tasarlama ve oluşturma.

Tek bir projede birden çok Microsoft Office uygulaması lication özelliğini kullanma

Visual Studio'daki her Office proje şablonu, tek bir Microsoft Office uygulaması ile çalışacak şekilde tasarlanmıştır. Birden çok Microsoft Office uygulaması'sindeki özellikleri kullanmak veya Visual Studio'da projesi olmayan bir uygulama veya bileşendeki özellikleri kullanmak için, gerekli PIA'lara bir başvuru eklemeniz gerekir.

Çoğu durumda, dizininin altına %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ Visual Studio tarafından yüklenen PIA'lara başvuru eklemeniz gerekir. Derlemelerin bu sürümleri, Başvuru Yöneticisi iletişim kutusunun Çerçeve sekmesinde görünür. Daha fazla bilgi için bkz. Nasıl yapılır: Birincil birlikte çalışma derlemeleri aracılığıyla Office uygulaması'leri hedefleme.

PIA'ları genel derleme önbelleğine yüklediyseniz ve kaydettiyseniz, derlemelerin bu sürümleri Başvuru Yöneticisi iletişim kutusunun COM sekmesinde görünür. Derlemeleri kullandığınızda ortaya çıkabilecek bazı geliştirme sorunları olduğundan derlemelerin bu sürümlerine başvuru eklemekten kaçının. Örneğin, PIA'ların farklı sürümlerini genel derleme önbelleğine kaydettiyseniz, Başvuru Yöneticisi iletişim kutusunun COM sekmesinde derlemenin farklı bir sürümünü belirtseniz bile projeniz en son kaydedilen derleme sürümüne otomatik olarak bağlanır.

Not

Bazı derlemeler, bunlara başvuran bir derleme eklendiğinde projeye otomatik olarak eklenir. Örneğin, Word, Excel, Office.dll Outlook, Microsoft Forms veya Graph derlemelerine başvuru eklediğinizde ve Microsoft.Vbe.Interop.dll derlemelerine başvurular otomatik olarak eklenir.

Microsoft Office uygulaması lications için birincil birlikte çalışma derlemeleri

Aşağıdaki tabloda, Office 2016, Office 2013 ve Office 2010 için kullanılabilen birincil birlikte çalışma derlemeleri listelenir.

Office uygulaması veya bileşen	Birincil birlikte çalışma derleme adı
Microsoft Access 14.0 Nesne Kitaplığı Microsoft Access 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.Access.dll
Microsoft Office 14.0 Access Veritabanı Altyapısı Nesne Kitaplığı Microsoft Office 15.0 Access Veritabanı Altyapısı Nesne Kitaplığı	Microsoft.Office.Interop.Access.Dao.dll
Microsoft Excel 14.0 Nesne Kitaplığı Microsoft Excel 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.Excel.dll
Microsoft Graph 14.0 Nesne Kitaplığı (Grafikler için PowerPoint, Access ve Word tarafından kullanılır) Microsoft Graph 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.Graph.dll
Microsoft InfoPath 2.0 Tür Kitaplığı (yalnızca InfoPath 2007 için)	Microsoft.Office.Interop.InfoPath.dll
Microsoft InfoPath XML Birlikte Çalışma Derlemesi (yalnızca InfoPath 2007 için)	Microsoft.Office.Interop.InfoPath.Xml.dll
Microsoft Office 14.0 Nesne Kitaplığı (Office paylaşılan işlevselliği) Microsoft Office 15.0 Nesne Kitaplığı (Office paylaşılan işlevselliği)	office.dll
Microsoft Office Outlook Görünüm Denetimi (Gelen Kutunuza erişmek için Web sayfalarında ve uygulamalarda kullanılabilir)	Microsoft.Office.Interop.OutlookViewCtl.dll
Microsoft Outlook 14.0 Nesne Kitaplığı Microsoft Outlook 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.Outlook.dll
Microsoft PowerPoint 14.0 Nesne Kitaplığı Microsoft PowerPoint 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.PowerPoint.dll
Microsoft Project 14.0 Nesne Kitaplığı Microsoft Project 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.MSProject.dll
Microsoft Publisher 14.0 Nesne Kitaplığı Microsoft Publisher 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.Publisher.dll
Microsoft SharePoint Tasarım Aracı 14.0 Web Nesnesi Başvuru Kitaplığı	Microsoft.Office.Interop.SharePoint Tasarım Aracı.dll
Microsoft SharePoint Tasarım Aracı 14.0 Sayfa Nesne Başvuru Kitaplığı	Microsoft.Office.Interop.SharePoint Tasarım Aracı Page.dll
Microsoft Akıllı Etiketler 2.0 Tür Kitaplığı Not: Akıllı etiketler Excel 2010 ve Word 2010'da kullanım dışıdır.	Microsoft.Office.Interop.SmartTag.dll
Microsoft Visio 14.0 Tür Kitaplığı Microsoft Visio 15.0 Tür Kitaplığı	Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Web Türü Kitaplığı Olarak Kaydet Microsoft Visio 15.0 Web Türü Kitaplığı Olarak Kaydet	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Microsoft Visio 14.0 Çizim Denetim Türü Kitaplığı Microsoft Visio 15.0 Çizim Denetim Türü Kitaplığı	Microsoft.Office.Interop.VisOcx.dll
Microsoft Word 14.0 Nesne Kitaplığı Microsoft Word 15.0 Nesne Kitaplığı	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Genişletilebilirlik 5.3	Microsoft.Vbe.Interop.dll

Yeniden yönlendirme derlemelerini bağlama

Office PIA'larını genel derleme önbelleğine yükleyip kaydettiğinizde (Office ile veya PIA'lar için yeniden dağıtılabilir paketi yükleyerek), bağlama yeniden yönlendirme derlemeleri de yalnızca genel derleme önbelleğine yüklenir. Bu derlemeler, birincil birlikte çalışma derlemelerinin doğru sürümünün çalışma zamanında yüklendiğinden emin olur.

Örneğin, bir Office 2010 derlemesine başvuran bir çözüm aynı birincil birlikte çalışma derlemesinin Office 2013 sürümüne sahip bir bilgisayarda çalıştırıldığında, bağlama yeniden yönlendirme derlemesi .NET Framework çalışma zamanına birincil birlikte çalışma derlemesinin Office 2013 sürümünü yükleme talimatını gönderir.

Daha fazla bilgi için bkz . Nasıl yapılır: Otomatik bağlama yeniden yönlendirmesini etkinleştirme ve devre dışı bırakma.