primární spolupracující sestavení sady Office

Pokud chcete používat funkce systém Microsoft Office aplikace z projektu Office, musíte pro aplikaci použít primární sestavení vzájemné spolupráce (PIA). Pia umožňuje spravovanému kódu pracovat s objektovým modelem modelu MODELU COM systém Microsoft Office aplikace.

Poznámka:

Zajímá vás vývoj řešení, která rozšiřují prostředí Office napříč několika platformami? Podívejte se na nový model doplňků pro Office. Doplňky pro Office mají v porovnání s doplňky a řešeními VSTO malé nároky a můžete je vytvářet pomocí téměř jakékoli webové programovací technologie, jako je HTML5, JavaScript, CSS3 a XML.

Když vytvoříte nový projekt Office, Visual Studio přidá odkazy na PIA, které jsou potřeba k sestavení projektu. V některých scénářích může být potřeba přidat odkazy na jiné PIA (například můžete použít funkci systém Microsoft Office Wordu v projektu pro systém Microsoft Office Excel).

Tento článek popisuje následující aspekty používání systém Microsoft Office PIA v projektech Office:

Další informace o primárních sestaveních vzájemné spolupráce naleznete v tématu Primární sestavení vzájemné spolupráce.

Oddělení primárních sestavení vzájemné spolupráce pro sestavování a spouštění projektů

Visual Studio používá různé sady piA na vývojovém počítači. Tyto různé sady sestavení jsou v následujících umístěních:

  • Složka v adresáři programových souborů

    Tato sada sestavení se používá při psaní kódu a sestavení projektů. Visual Studio tato sestavení nainstaluje automaticky.

  • Globální mezipaměť sestavení

    Tato sada sestavení se používá během některých vývojových úloh, například při spuštění nebo ladění projektů. Visual Studio nenainstaluje a zaregistruje tato sestavení; musíš to udělat sami.

Primární sestavení vzájemné spolupráce v adresáři programových souborů

PiA se při instalaci sady Visual Studio automaticky přidají do umístění v systému souborů mimo globální mezipaměť sestavení. Když vytvoříte nový projekt, Visual Studio automaticky přidá odkazy na tyto kopie PIA do projektu. Visual Studio používá tyto kopie PIA místo sestavení v globální mezipaměti sestavení k překladu odkazů na typy při vývoji a sestavení projektu.

Pokud jsou v globální mezipaměti sestavení zaregistrované různé verze PIA, můžete čelit několika problémům s vývojem. Přidané kopie piA vám pomůžou vyhnout se takovým problémům.

Pro Visual Studio 2017 a novější se tyto kopie piA nainstalují do následujících sdílených umístění na vývojovém počítači:

  • %ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

  • (nebo %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ v 64bitových operačních systémech)

Poznámka:

U starších verzí sady Visual Studio se tyto PIA nainstalují do složky Visual Studio Tools for Office\PIA ve %ProgramFiles% složce pro danou verzi sady Visual Studio. Příklad: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Primární sestavení vzájemné spolupráce v globální mezipaměti sestavení

Aby bylo možné provádět určité úlohy vývoje, musí být piA nainstalované a zaregistrované v globální mezipaměti sestavení na vývojovém počítači. PiA se obvykle instalují automaticky při instalaci Office na vývojový počítač. Další informace najdete v tématu Konfigurace počítače pro vývoj řešení Office.

Pro spouštění řešení Office se na počítačích koncových uživatelů nevyžadují pia Office. Další informace najdete v tématu Návrh a vytvoření řešení Office.

Použití funkcí více systém Microsoft Office aplikací v jednom projektu

Každá šablona projektu Office v sadě Visual Studio je navržená tak, aby fungovala s jednou aplikací systém Microsoft Office. Pokud chcete používat funkce ve více systém Microsoft Office aplikacích nebo používat funkce v aplikaci nebo komponentě, které nemají projekt v sadě Visual Studio, musíte přidat odkaz na požadované piA.

Ve většině případů byste měli přidat odkazy na PIA, které jsou nainstalovány sadou Visual Studio v %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ adresáři. Tyto verze sestavení se zobrazí na kartě Framework v dialogovém okně Správce odkazů. Další informace naleznete v tématu Postupy: Cílení aplikace Office lications prostřednictvím primárních sestavení vzájemné spolupráce.

Pokud jste nainstalovali a zaregistrovali PIA v globální mezipaměti sestavení, zobrazí se tyto verze sestavení na kartě COM v dialogovém okně Správce odkazů. Vyhněte se přidávání odkazů na tyto verze sestavení, protože existují některé problémy s vývojem, ke kterým může dojít při jejich použití. Pokud jste například zaregistrovali různé verze PIA v globální mezipaměti sestavení, projekt se automaticky vytvoří vazbu na verzi sestavení, která byla zaregistrována jako poslední, i když zadáte jinou verzi sestavení na kartě COM dialogového okna Správce odkazů.

Poznámka:

Některá sestavení se do projektu přidají automaticky při přidání sestavení, které je odkazuje. Například odkazy na sestavení Office.dll a Microsoft.Vbe.Interop.dll sestavení se přidají automaticky, když přidáte odkaz na sestavení Aplikace Word, Excel, Outlook, Microsoft Forms nebo Graph.

Primární sestavení vzájemné spolupráce pro aplikace systém Microsoft Office

Následující tabulka uvádí primární sestavení vzájemné spolupráce, která jsou dostupná pro Office 2016, Office 2013 a Office 2010.


aplikace Office lication or component Název primárního sestavení vzájemné spolupráce
Microsoft Access 14.0 – knihovna objektů

Microsoft Access 15.0 – knihovna objektů
Microsoft.Office.Interop.Access.dll
systém Microsoft Office 14.0 Knihovna objektů databázového stroje Access

systém Microsoft Office 15.0 Knihovna objektů databázového stroje Access
Microsoft.Office.Interop.Access.Dao.dll
Microsoft Excel 14.0 – knihovna objektů

Microsoft Excel 15.0 – knihovna objektů
Microsoft.Office.Interop.Excel.dll
Knihovna objektů Microsoft Graph 14.0 (používaná v PowerPointu, Accessu a Wordu pro grafy)

Knihovna objektů Microsoft Graph 15.0
Microsoft.Office.Interop.Graph.dll
Knihovna typů aplikace Microsoft InfoPath 2.0 (pouze pro aplikaci InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Sestavení zprostředkovatele komunikace XML aplikace Microsoft InfoPath (pouze pro aplikaci InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
systém Microsoft Office 14.0 – knihovna objektů (sdílené funkce Office)

systém Microsoft Office 15.0 Object Library (sdílené funkce Office)
office.dll
aplikace Microsoft Office Outlook Ovládací prvek zobrazení (můžete ho použít na webových stránkách a aplikacích pro přístup ke složce Doručená pošta). Microsoft.Office.Interop.OutlookViewCtl.dll
Knihovna objektů aplikace Microsoft Outlook 14.0

Knihovna objektů aplikace Microsoft Outlook 15.0
Microsoft.Office.Interop.Outlook.dll
Knihovna objektů Microsoft PowerPointu 14.0

Knihovna objektů Microsoft PowerPointu 15.0
Microsoft.Office.Interop.PowerPoint.dll
Microsoft Project 14.0 – knihovna objektů

Microsoft Project 15.0 – knihovna objektů
Microsoft.Office.Interop.MSProject.dll
Knihovna objektů aplikace Microsoft Publisher 14.0

Knihovna objektů aplikace Microsoft Publisher 15.0
Microsoft.Office.Interop.Publisher.dll
Referenční knihovna webových objektů aplikace Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Knihovna odkazů na objekty stránky aplikace Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Microsoft Smart Tags 2.0 Type Library Poznámka: Inteligentní značky jsou zastaralé v Excelu 2010 a Wordu 2010. Microsoft.Office.Interop.SmartTag.dll
Knihovna typů aplikace Microsoft Visio 14.0

Knihovna typů aplikace Microsoft Visio 15.0
Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Uložit jako knihovnu webových typů

Microsoft Visio 15.0 Uložit jako knihovnu webových typů
Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Knihovna typů ovládacích prvků výkresu aplikace Microsoft Visio 14.0

Knihovna typů ovládacích prvků výkresu aplikace Microsoft Visio 15.0
Microsoft.Office.Interop.VisOcx.dll
Microsoft Word 14.0 Object Library

Microsoft Word 15.0 Object Library
Microsoft.Office.Interop.Word.dll
Rozšiřitelnost microsoft jazyk Visual Basic for Application 5.3 Microsoft.Vbe.Interop.dll

Sestavení přesměrování vazby

Při instalaci a registraci pia Office v globální mezipaměti sestavení (buď s Office, nebo instalací distribuovatelného balíčku pro PIA), sestavení přesměrování vazby jsou také nainstalována pouze v globální mezipaměti sestavení sestavení. Tato sestavení zajišťují, že se za běhu načte správná verze primárních sestavení vzájemné spolupráce.

Pokud například řešení, které odkazuje na sestavení Office 2010, běží na počítači s verzí Office 2013 stejného primárního sestavení vzájemné komunikace, sestavení přesměrování vazby dává modulu runtime .NET Framework pokyn k načtení verze Office 2013 primárního sestavení vzájemné spolupráce.

Další informace naleznete v tématu Postupy: Povolení a zakázání automatického přesměrování vazby.