Architektura přizpůsobení na úrovni dokumentu
Visual Studio 2013zahrnuje projekty pro vytváření přizpůsobení úrovni dokumentu aplikace Microsoft Office Word a Microsoft Office Excel.Toto téma popisuje následující aspekty úpravy na úrovni dokumentu:
Princip úpravy
Vlastní nastavení součásti
Způsob úpravy práce s aplikací Microsoft Office
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu v těchto aplikacích: Excel 2013 a Excel 2010; Word 2013 a Word 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.
Obecné informace o vytváření vlastní úrovni dokumentu, viz Přehled vývoje řešení pro systém Office, Začínáme s programováním přizpůsobení pro aplikaci Word na úrovni dokumentů, a Začínáme s programováním přizpůsobení pro aplikaci Excel na úrovni dokumentů.
Princip úpravy
Při použití nástroje pro vývojáře sady Office v aplikaci Visual Studio pro sestavení úrovni dokumentu přizpůsobení, vytvoření sestavení spravovaného kódu, který je spojen s určitým dokumentem.Dokument nebo sešit s propojených sestavení se říká obsahovat spravovaný kód rozšíření.Další informace naleznete v tématu Navrhování a tvorba řešení pro systém Office.
Když uživatel otevře dokument, sestavení je načten v aplikaci Microsoft Office.Po načtení sestavení vlastního nastavení může reagovat na události v otevřeném dokumentu.Vlastní nastavení můžete také volat do modelu objektu automatizace a rozšířit působnost a dokument je otevřen, můžete použít třídy v .NET Framework.
Sestavení komunikuje s komponentami modelu COM aplikace prostřednictvím primární definiční sestavení aplikace.Další informace naleznete v tématu Sestavení primární spolupráce sady Office a Přehled vývoje řešení pro systém Office.
Pokud uživatel otevře více přizpůsobení úrovni dokumentu současně, každý sestavení je načten v různých aplikačních domén.To znamená, že jedno řešení, které se chovají nesprávně, nemůže způsobit další řešení selhání.Přizpůsobení úrovni dokumentu jsou navrženy pro práci s jeden dokument v jediné doméně aplikace.Nejsou určeny pro komunikaci mezi dokument.Další informace o aplikačních domén naleznete v tématu Aplikační domény.
[!POZNÁMKA]
Úpravy úrovni dokumentu, které vytvoříte pomocí nástroje pro vývojáře sady Office v aplikaci Visual Studio mají používat pouze v případě, že je aplikace spuštěna koncového uživatele.Pokud je aplikace spuštěna programově, například pomocí funkce automatizace, vlastní nastavení nemusí fungovat podle očekávání.
Zkušenosti v době návrhu a Run-Time
Pro pochopení architektury úrovni dokumentu úprav, je užitečné porozumět prostředí návrhu řešení a řešení systémem.
Doba návrhu
Možnosti návrhu zahrnuje následující kroky:
Vývojář vytvoří úrovni dokumentu projekt v Visual Studio.Projekt zahrnuje dokument a sestavení, které běží na pozadí dokumentu.Dokument může již existovat (případně vytvořena návrhářem) nebo lze vytvořit nový dokument a projektu.
Návrhář – buď vývojář, který vytvoří projekt nebo někdo jiný – vytváří konečný vzhled dokumentu pro koncového uživatele.
Čas spuštění
Běhové prostředí zahrnuje následující kroky:
Koncový uživatel otevře dokument nebo sešit, který obsahuje spravovaný kód rozšíření.
Dokument nebo sešit načte zkompilované sestavení.
Sestavení reaguje na události jako uživatel pracuje v dokumentu nebo sešitu.
Developer a perspektivy koncovému uživateli ve srovnání
Vzhledem k tomu, že vývojář pracuje především v Visual Studioa koncový uživatel pracuje v aplikaci Word nebo Excel, existují dva způsoby Principy přizpůsobení úrovni dokumentu.
Perspektiva pro vývojáře |
Perspektiva pro koncového uživatele |
|---|---|
Pomocí Visual Studio, vývojář zapíše kód, který je přístupný pro Word a Excel. Ačkoli se může zdát, že vývojáři vytváří spustitelný soubor, který spouští aplikaci Word nebo Excel, proces skutečně funguje opačným způsobem.Dokument je přidružen k sestavení a obsahuje odkaz na sestavení.Po otevření dokumentu aplikace Word nebo Excel vyhledává sestavení a spustí kód v reakci na všechny zpracované události. |
Ty, kteří používají řešení jednoduše otevřít dokument nebo sešit (nebo vytvořit nový dokument ze šablony) stejně jako by otevření jakéhokoli jiného souboru aplikace Microsoft Office. Sestavení poskytuje vlastního nastavení v dokumentu nebo sešitu, například automaticky naplnění aktuální data nebo zobrazení dialogové okno pro vyžádání informací. |
Podporované formáty dokumentů pro úpravy na úrovni dokumentu
Při vytváření vlastního nastavení projektu, můžete zvolit formát dokumentu, který chcete použít v projektu.Další informace naleznete v tématu Postupy: Vytváření projektů pro systém Office v prostředí Visual Studio.
V následující tabulce jsou uvedeny formáty dokumentů, které lze použít v přizpůsobení úrovni dokumentu aplikace Excel a Word.
Aplikace Excel |
Word |
|---|---|
Sešit aplikace Excel (XLSX) Sešit aplikace Excel s povolenými makry (XLSM) Binární sešit aplikace Excel (XLSB) Aplikace Excel 97-2003 (XLS) Šablona aplikace Excel (XLTX) Šablona aplikace Excel s podporou maker (XLTM) Aplikace Excel 97-2003 Šablona (XLT) |
Dokument aplikace Word (DOCX) Dokument aplikace Word s podporou maker (DOCM) Dokument aplikace Word 97-2003 (DOC) Šablona aplikace Word (dotx) Šablona aplikace Word s podporou maker (.dotm) Šablona aplikace Word 97-2003 (dot) |
Měli byste navrhnout rozšíření spravovaný kód pouze pro dokumenty v podporovaném formátu.Určité události, jinak pravděpodobně aktivována, po otevření dokumentu v aplikaci.Například Open událost není aktivována při použití rozšíření spravovaný kód s sešity uložené ve formátu tabulky XML aplikace Excel nebo webovou stránku (HTM; Formát HTML).
Podpora pro dokumenty aplikace Word, které mají přípony názvů souborů XML
Šablony projektů na úrovni dokumentu neumožňuje vytvořit projekty založené na následující formáty souborů:
Dokument XML aplikace Word (* xml).
Dokument XML aplikace Word 2003 (* xml).
Pokud chcete koncovým uživatelům používat vlastní nastavení v těchto formátech souborů, sestavení a nasazení vlastního nastavení, který používá jeden podporované formáty souborů uvedené v předchozí tabulce.Koncoví uživatelé po instalaci vlastního nastavení, můžete uložit dokument v dokumentu XML aplikace Word (* xml) formát nebo dokument XML aplikace Word 2003 (* xml) formát a přizpůsobení budou nadále fungovat očekávaným způsobem.
Vlastní nastavení součásti
Hlavní součásti vlastního nastavení jsou dokument a sestavení.Kromě těchto složek existuje několik částí, které hrají důležitou roli v jak aplikací Microsoft Office zjišťovat a načíst vlastní nastavení.
Manifestu nasazení a manifestu aplikace
Vlastní nastavení pomocí manifestů aplikace a manifesty nasazení identifikovat a načíst poslední verzi sestavení vlastního nastavení.Nasazení manifestu odkazuje na aktuální manifestu aplikace.Aplikace manifest odkazuje na sestavení vlastního nastavení a určuje vstupní bod třídy (nebo třídy) provádět v sestavení.Další informace naleznete v tématu Manifesty aplikací a nasazení v řešeních pro systém Office.
Visual Studio Tools for Office Runtime
Na úrovni dokumentu úprav, které jsou vytvořeny pomocí nástroje pro vývojáře sady Office v aplikaci Visual Studio spustit, musí mít počítače koncového uživatele Visual Studio Tools for Office runtime nainstalován.Visual Studio Tools for Office runtime Zahrnuje nespravovanými komponentami, které načíst sestavení vlastního nastavení a sadu spravovaných sestavení.Tyto spravované sestavení poskytují objektový model, který používá váš kód přizpůsobení automatizovat a rozšiřovat do hostitelské aplikace.
Další informace naleznete v tématu Přehled nástrojů Visual Studio Tools for Office runtime.
Jak vlastní práce s aplikacemi sady Microsoft Office
Při otevření dokumentu, který je součástí Microsoft Office přizpůsobení aplikace používá manifestu nasazení, který je propojen k dokumentu vyhledat a načíst poslední verzi sestavení vlastního nastavení.Umístění manifestu nasazení je uložen v dokumentu vlastní vlastnost s názvem _AssemblyLocation.Řetězec, který identifikuje umístění je vložen do vlastnosti při vytváření řešení.
Body manifestu nasazení do manifestu aplikace, který potom odkazuje na aktuální sestavení.Další informace naleznete v tématu Manifesty aplikací a nasazení v řešeních pro systém Office.
Následující obrázek znázorňuje základní architektury přizpůsobení úrovni dokumentu.
Architektura vlastního nastavení
.png "Architektura přizpůsobení systému office 2007")
[!POZNÁMKA]
V řešeních Office, které se zaměřují .NET Framework 4, řešení volání do objektového modelu aplikace hostitele pomocí pomocí primární sestavení interop (PIA) informace o typu, který je vložen v sestavení řešení, namísto volání přímo do primární.Další informace naleznete v tématu Navrhování a tvorba řešení pro systém Office.
Proces načítání
Když uživatel otevře dokument, který je součástí řešení Microsoft Office proběhnou následující kroky.
Aplikace Microsoft Office kontroluje vlastností souboru a zjistěte, zda jsou rozšíření spravovaný kód přidružený k dokumentu.Další informace naleznete v tématu Přehled přizpůsobených vlastností dokumentu.
Pokud nejsou rozšíření spravovaný kód, aplikace načte VSTOEE.dll, který načte VSTOLoader.dll.Jedná se o nespravovaných DLL knihovnách, které jsou součástí zavaděče pro Visual Studio 2010 Tools for Office Runtime.Další informace naleznete v tématu Přehled nástrojů Visual Studio Tools for Office runtime.
Načte VSTOLoader.dll .NET Framework a spravovaná část začíná Visual Studio Tools for Office runtime.
Pokud je otevřen dokument z jiného umístění než do místního počítače, Visual Studio Tools for Office runtime ověří, zda je umístění dokumentu v Důvěryhodná umístění seznam Nastavení Centra zabezpečení pro konkrétní aplikaci sady Office.Pokud umístění dokumentu není v důvěryhodném umístění, vlastní nastavení není důvěryhodný a ukončí proces načítání zde.
Visual Studio Tools for Office runtime Nainstaluje řešení, pokud ještě nebyl nainstalován, stáhne nejnovější manifesty aplikace a nasazení a provádí řadu kontrol zabezpečení.Další informace naleznete v tématu Zabezpečení řešení pro systém Office.
Pokud vlastní nastavení důvěryhodný spustit, Visual Studio Tools for Office runtime používá pro vyhledání aktualizací sestavení v manifestu nasazení a manifestu aplikace.Pokud je k dispozici nová verze sestavení, modul runtime stáhne novou verzi sestavení, které má ClickOnce mezipaměti v klientském počítači.Další informace naleznete v tématu Nasazení řešení Office.
Visual Studio Tools for Office runtime Vytvoří novou doménu aplikace, do kterého chcete načíst sestavení vlastního nastavení.
Visual Studio Tools for Office runtime Vlastní sestavení načte do domény aplikace.
Visual Studio Tools for Office runtime Volání Startup obslužnou rutinu události v sestavení vašeho vlastního nastavení.Další informace naleznete v tématu Události v projektech pro systém Office
Viz také
Koncepty
Architektura doplňků na úrovni aplikace
Přehled nástrojů Visual Studio Tools for Office runtime
Přehled přizpůsobených vlastností dokumentu
Data uložená v mezipaměti v přizpůsobeních na úrovni dokumentu
Další zdroje
Architektura řešení pro systém Office v sadě Visual Studio