Psaní kódu v řešeních pro systém Office

Článek
05/16/2015

Existují některé aspekty psaní kódu v projektech systému Office, které se liší od jiných typů projektů v aplikaci Visual Studio.Mnohé z těchto rozdílů souvisí způsob Office objektových modelů jsou vystaveny na spravovaný kód.Další rozdíly jsou vzájemně propojeny v návrhu Office projekty.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v Office 2013 a v Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Spravovaný kód a programování Office

Klíčové technologie, která umožňuje vytváření integrované řešení Microsoft Office je automatizace, který je součástí technologie modelu COM (Component Object).Automatizace umožňuje kódu slouží k vytvoření a řízení softwarových objektů, které jsou vystaveny pomocí libovolné aplikace, knihovny DLL, nebo ovládacího prvku ActiveX podporuje příslušné programové rozhraní.

Principy primární sestavení Interop

Aplikace Microsoft Office poskytují většinu jejich funkcí automatizace.Spravovaný kód (například Visual Basic nebo C#) však nelze použít přímo k automatizaci aplikace sady Office.Pokud chcete automatizovat aplikace systému Office s použitím spravovaného kódu, je nutné použít Office primární sestavení interop (PIA).Primární sestavení interop umožňují spravovanému kódu pracovat s modelem založená na modelu COM objektů aplikací sady Office.

Každá aplikace Microsoft Office obsahuje moduly PIA.Při vytváření projektu aplikace sady Office v aplikaci Visual Studio, odkaz na příslušnou PIA je automaticky přidán do projektu.K automatizaci funkcí ostatních aplikací sady Office z projektu, musíte přidat odkaz na příslušné PIA ručně.Další informace naleznete v tématu Postupy: Cílení na aplikace Office v primárních sestaveních vzájemné spolupráce.

Pomocí primární sestavení Interop v době návrhu a doba zpracování

Musí mít PIA Office nainstalován a registrován v globální mezipaměť sestavení (GAC) na vašem vývojovém počítači provádět většinu úkolů rozvoje.Další informace naleznete v tématu Konfigurace počítače pro vývoj řešení pro systém Office.

Sestaveních PIA sady Office není nutné v počítačích koncových uživatelů spustit řešení systému Office cílených .NET Framework 4 nebo .NET Framework 4,5.Další informace naleznete v tématu Navrhování a tvorba řešení pro systém Office.

Pomocí typů v primární sestavení Interop

Sestaveních PIA sady Office obsahují kombinaci typů, které poskytují objektový model aplikací sady Office a další infrastruktury typy, které nejsou určeny k použití přímo v kódu.Přehled typů v sestaveních PIA sady Office naleznete v tématu Overview of Classes and Interfaces in the Office Primary Interop Assemblies.

Proto typy v sestaveních PIA sady Office odpovídají typům v modelech založená na modelu COM objektu, způsobu použití těchto typů je často liší od ostatních spravovaných typů.Například způsob volání metody, které mají volitelné parametry v Office primární definiční sestavení závisí na programovací jazyk, který používáte v projektu.Další informace naleznete v následujících tématech:

Programovací Model pro projekty Office

Všechny projekty Office zahrnují jeden nebo více generované třídy, které poskytují vstupní bod pro váš kód.Tyto třídy také poskytují přístup k objektovému modelu aplikace hostitele a přístup k funkcím, jako jsou například podokna akcí a vlastní podokna úloh.

Principy generované třídy

Generované třídy v úrovni dokumentu projekty pro Excel a Word, podobný objekt nejvyšší úrovně v aplikačním objektovém modelu.Například generované ThisDocument třídy v projektu dokumentu aplikace Word obsahuje stejné členy jako Document třídy v objektovém modelu aplikace Word.Další informace o generované třídy na úrovni dokumentu projektech naleznete v Programování přizpůsobení na úrovni dokumentu.

Projekty na úrovni aplikace poskytují generované třídy nazývá ThisAddIn.Tato třída není podobné třídy v objektovém modelu aplikace hostitele.Místo toho tato třída představuje doplněk sám a poskytuje členy, které lze použít pro přístup k modelu objektu aplikace hostitele a přistupovat k dalším funkcím, které jsou k dispozici doplňky.Další informace naleznete v tématu Programování doplňků na úrovni aplikace.

Zahrnout všechny generované třídy v projektech systému Office Startup a Shutdown obslužné rutiny událostí.Začněte psát kód obvykle přidejte kód pro tyto obslužné rutiny událostí.K inicializaci doplněk, můžete přidat kód, který Startup obslužnou rutinu události.K vyčištění prostředků používaných doplněk, můžete přidat kód, který Shutdown obslužnou rutinu události.Další informace naleznete v tématu Události v projektech pro systém Office.

Přístup k generované třídy v době spuštění

Při načítání Office řešení Visual Studio Tools for Office runtime konkretizuje každé generované třídy do projektu.Tyto objekty můžete přístup z jakéhokoli kódu v projektu pomocí Globals třídy.Například můžete použít Globals třída pro volání kódu ThisAddIn třídy z obslužné rutiny události tlačítka na pásu karet v aplikace úroveň doplněk.

Další informace naleznete v tématu Globální přístup k objektům v projektech pro systém Office.

Důležité informace o oboru názvů v řešeních Office

Nelze změnit výchozí obor názvů (nebo kořenový obor názvů v jazyce Visual Basic) aplikace Office project, po vytvoření projektu.Výchozí obor názvů, budou vždy odpovídat název projektu, který jste zadali při vytváření projektu.Pokud přejmenujete projekt, nedojde ke změně výchozí obor názvů.Další informace o výchozí obor názvů v projektech naleznete v tématu Stránka Aplikace, návrhář projektu (C#) a Stránka Aplikace, návrhář projektu (Visual Basic).

Změna oboru názvů tříd položku hostitele v C# projekty

Hostitel položka třídy (například ThisAddIn, ThisWorkbook, nebo ThisDocument třídy) mají své vlastní obory názvů v projekty Visual C# Office.Výchozí obor názvů pro hostitele položek v projektu odpovídá název projektu, který jste zadali při vytváření projektu.

Můžete změnit obor názvů hostitele položek v projektu Visual C# Office obor názvů pro hostitele zboží vlastnost.Další informace naleznete v tématu Vlastnosti v projektech pro systém Office.

Podporované programovací jazyky v projektech systému Office

Projekt šablony sady Office v aplikaci Visual Studio podporuje pouze Visual Basic a Visual C# programovací jazyky.Proto tyto šablony projektu jsou k dispozici pouze v rámci jazyka Visual Basic a Visual C# uzly Nový projekt dialogového okna v Visual Studio.Další informace naleznete v tématu Postupy: Vytváření projektů pro systém Office v prostředí Visual Studio.

Volbou jazyka a programování Office

Microsoft Office a Visual Basic for Applications (VBA) byly vyvinuty tak, aby společně optimalizovat pracovní postup vlastního nastavení aplikace.Některé tyto skutečnosti zdědil jazyka Visual Basic.Například Visual Basic podporuje volitelné parametry, což znamená, že můžete zapsat menší část kódu při volání některé metody v primární definiční sestavení Microsoft Office než při použití Visual C#.

Programování pomocí jazyka Visual Basic vs. Visual C# v řešeních Office

Můžete vytvořit řešení Office pomocí jazyka Visual Basic nebo Visual C#.Protože objektových modelů aplikace Microsoft Office byly navrženy pro použití s Microsoft Visual Basic for Applications (VBA), vývojáři Microsoft Visual Basic můžete pohodlně pracovat s objekty, které jsou vystaveny v aplikacích Microsoft Office.V Visual Studio 2013, Visual C# mohou vývojáři většinu stejných funkcí jako vývojáře jazyka Visual Basic, existují však některé případy, kdy musí psát další kód pomocí objektových modelů Office.Existují také některé rozdíly mezi základní programovací funkce ve vývoji Office a spravovaný kód napsaný v jazyce Visual Basic a C#.

Hlavní rozdíly mezi jazyka Visual Basic a Visual C#

V následující tabulce ukazuje hlavní rozdíly mezi jazyka Visual Basic a Visual C# ve vývoji Office.

Funkce	Description	Podpora jazyka Visual Basic	Visual C# podpora
Volitelné parametry	Mnoho metod pro Microsoft Office mají parametry, které nejsou povinné při volání metody.Pokud parametr je předán žádnou hodnotu, je použita výchozí hodnota.	Visual Basic podporuje volitelné parametry.	Visual C# podporuje volitelné parametry ve většině případů.Další informace naleznete v tématu Volitelné parametry v řešeních pro systém Office.
Předávání parametrů odkazem	Volitelné parametry ve většině primární definiční sestavení Microsoft Office může být předán podle hodnoty.Některé primární definiční sestavení, musí být předán volitelné parametry, které přijímají typy odkazů odkaz. Další informace o referenční hodnoty a parametry typu, naleznete v Předávání argumentů podle hodnoty a odkazu (Visual Basic) (pro Visual Basic) a Předávání parametrů (Průvodce programováním v C#).	Žádná další práce je potřeba předat parametry odkaz.Kompilátor jazyka Visual Basic automaticky předá parametry podle potřeby.	Ve většině případů Visual C# kompilátor automaticky předá parametry podle potřeby.Další informace naleznete v tématu Volitelné parametry v řešeních pro systém Office.
Parametrické vlastnosti.	Některé vlastnosti přijímat parametry a zajišťovat funkce určené jen pro čtení.	Visual Basic podporuje vlastnosti, které přijímají parametry.	Visual C# podporuje vlastnosti, které přijímají parametry.
Pozdní vazba	Pozdní vazbu zahrnuje stanovení vlastností objektů za běhu, nikoli přetypování proměnné typu objektu v době návrhu.	Visual Basic provede pozdní vazby při Option Strict je vypnuto.Při Option Strict je, je nutné explicitně převést objekty a typy použití v System.Reflection obor názvů pro přístup k členům pozdní vazbou.Další informace naleznete v tématu Pozdní vazba v řešeních pro systém Office.	Visual C# provede pozdní vazby v projektech, které se zaměřují .NET Framework 4.Další informace naleznete v tématu Pozdní vazba v řešeních pro systém Office.

Hlavní rozdíly mezi vývoj Office a spravovaný kód

Následující tabulka ukazuje hlavní rozdíly mezi vývoj Office a spravovaný kód napsaný v jazyce Visual Basic nebo Visual C#.

Funkce	Description	Podpora jazyka Visual Basic a Visual C#
Pole indexů	Dolní mez pole kolekcí v aplikacích Microsoft Office začíná 1.Visual Basic a Visual C# pomocí pole založené na 0.Další informace naleznete v tématu Pole (Průvodce programováním v C#) a Pole v jazyce Visual Basic.	Pro přístup k první položku kolekce v objektovém modelu aplikace Microsoft Office, použijte index 1 namísto 0.