Architektura úpravy na úrovni dokumentu

Visual Studio 2012zahrnuje projekty pro vytvoření vlastní úroveň dokument pro aplikaci Microsoft Office Word a Microsoft Office Excel.Toto téma popisuje následující aspekty úpravy na úrovni dokumentu:

• Princip úpravy

• Součásti vlastního nastavení

• Způsob úpravy práce s aplikací Microsoft Office

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu v následujících aplikacích: Excel 2013 a Excel 2010, Word 2013 a Word 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Obecné informace o vytváření vlastního nastavení na úrovni dokumentu viz Přehled vývoje řešení sady Office, Začínáme úprav programování na úrovni dokumentu aplikace Word, a Začínáme úprav programování na úrovni dokumentu aplikace Excel.

Princip úpravy

Při použití nástroje pro vývojáře sady Office v aplikaci Visual Studio vytvořit vlastní úroveň dokument, vytvořte sestavení spravovaného kódu, který souvisí s konkrétní dokument.Dokument nebo sešit s propojených sestavení říká obsahovat spravovaný kód rozšíření.Další informace naleznete v tématu Navrhování a vytváření řešení Office.

Když uživatel otevře dokument, sestavení je načten v aplikaci Microsoft Office.Po načtení sestavení vlastního nastavení lze reagovat na události při otevření dokumentu.Přizpůsobení můžete také volat do modelu objektu automatizace a rozšiřovat aplikace při otevřeném dokumentu a lze použít třídy v .NET Framework.

Sestavení komunikuje s komponentami modelu COM aplikace prostřednictvím primárního definičního sestavení aplikace.Další informace naleznete v tématu Primární sestavení Interop Office a Přehled vývoje řešení sady Office.

Pokud uživatel otevře více úprav na ú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 selhání dalších řešení.Úpravy na úrovni dokumentu jsou navrženy pro práci s jeden dokument v doméně jednu aplikaci.Nejsou určeny pro komunikaci mezi dokumentu.Další informace o doménách aplikace viz Domény aplikace.

[!POZNÁMKA]

Úroveň dokumentu vlastní nastavení, které vytvoříte pomocí nástroje pro vývojáře sady Office v sadě Visual Studio jsou navrženy použít pouze při spuštění koncovým uživatelem aplikace.Pokud je aplikace spuštěna programově, například pomocí automatizace, přizpůsobení nemusí fungovat podle očekávání.

Návrh a prostředí Run-Time

Architektura úpravy úroveň dokument pochopit, pomůže pochopit zkušeností návrhu řešení a řešení systémem.

Návrhu

Zkušenosti návrhu zahrnuje následující kroky:

1. Vývojář vytvoří projekt úrovni dokumentu v Visual Studio.Projekt zahrnuje dokument a sestavení, který běží na pozadí dokumentu.Dokument již pravděpodobně existuje (případně vytvořena návrhářem) nebo s projektu lze vytvořit nový dokument.

2. Návrhář – buď vývojář, který vytvoří projekt nebo někdo jiný – konečný vzhled dokumentu vytvoří pro koncového uživatele.

Čas spuštění

Prostředí run-time zahrnuje následující kroky:

1. Koncový uživatel otevře dokument nebo sešit, který obsahuje spravovaný kód rozšíření.

2. Dokument nebo sešit načte zkompilované sestavení.

3. Sestavení reaguje na události jako uživatel pracuje v dokumentu nebo sešitu.

Developer a srovnání perspektivy koncového uživatele

Protože vývojář pracuje především v Visual Studioa koncový uživatel pracuje v aplikaci Word nebo Excel, existují dva způsoby Princip úpravy na úrovni dokumentu.

Perspektiva vývojáře

Koncový uživatel perspektivy

Pomocí Visual Studio, vývojář píše kód, který je přístupný pro Word a Excel. Ačkoli se může zdát, že vývojář je vytvoření spustitelného souboru, který spustí aplikaci Word nebo Excel, proces skutečně funguje opačným způsobem.Dokument je přidružen k sestavení a obsahuje ukazatel 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ření nového dokumentu ze šablony) stejně jako by se otevřou další soubor Microsoft Office. Sestavení poskytuje úprav v dokumentu nebo sešitu, například automaticky naplnění daty nebo dialogové okno informace o zobrazení.

Podporované formáty dokumentů pro vlastní nastavení na úrovni dokumentu

Při vytváření vlastního projektu můžete zvolit formát dokumentu, který chcete použít v projektu.Další informace naleznete v tématu Jak: vytvoření Office projekty v aplikaci Visual Studio.

V následující tabulce jsou uvedeny formáty dokumentů, které lze použít v úroveň dokument přizpůsobení pro Excel a Word.

Aplikace Excel	Word
Sešit aplikace Excel (XLSX) Sešit aplikace Excel s podporou maker (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 Word 97-2003 (DOC) Šablona aplikace Word (dotx) Šablony aplikace Word s podporou maker (*.dotm) Šablona Word 97-2003 (dot)

Měli byste navrhnout rozšíření spravovaný kód pouze pro dokumenty v podporovaných formátech.Určité události jinak nemusí vyvolána, když se dokument otevře 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 Tabulka XML aplikace Excel nebo webovou stránku (HTM; Formát HTML).

Podpora pro dokumenty aplikace Word XML přípony názvů souborů

Šablony dokumentu úroveň projektu neumožňují vytváření projektů založených 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á jednu 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.

Součásti vlastního nastavení

Hlavní součásti vlastního nastavení jsou dokument a sestavení.Kromě těchto komponent 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í slouží k identifikaci a načíst aktuální verzi sestavení vlastního manifestů aplikace a manifestů nasazení.Manifestu nasazení odkazuje na aktuální manifestu aplikace.Aplikace odkazuje na sestavení vlastní manifest a určuje vstupní bod třídy (nebo třídy) v sestavení.Další informace naleznete v tématu Aplikace a nasazení manifestů v Office Solutions.

Visual Studio Tools for Office Runtime

Spustit vlastní úroveň dokumentu, které jsou vytvořeny pomocí nástroje pro vývojáře sady Office v sadě Visual Studio, musí mít počítače koncovým uživatelem 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 hostitelské aplikace.

Další informace naleznete v tématu Visual Studio Tools pro přehled Runtime sady Office.

Způsob úpravy práce s aplikací Microsoft Office

Při otevření dokumentu, který je součástí Microsoft Office přizpůsobení aplikace používá propojený dokument vyhledat a načíst aktuální verzi sestavení vlastní manifest nasazení.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 sestavení řešení.

Body manifestu nasazení do manifestu aplikace pak odkazuje na aktuální sestavení.Další informace naleznete v tématu Aplikace a nasazení manifestů v Office Solutions.

Následující ilustrace znázorňuje základní architektura úpravy úroveň dokument.

Architektura vlastního nastavení

[!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í místo volání přímo do primární.Další informace naleznete v tématu Navrhování a vytváření řešení Office.

Proces načítání

Následující kroky dojít, pokud uživatel otevře dokument, který je součástí řešení Microsoft Office.

1. Aplikace Microsoft Office kontroluje vlastnosti dokumentu vlastní zda jsou rozšíření spravovaný kód přidružený k dokumentu.Další informace naleznete v tématu Vlastní přehled vlastností dokumentu.

2. Pokud nejsou rozšíření spravovaný kód, aplikace načte VSTOEE.dll, který načte VSTOLoader.dll.Nespravované knihovny DLL, které jsou součástí programu Visual Studio 2010 Tools for Office Runtime.Další informace naleznete v tématu Visual Studio Tools pro přehled Runtime sady Office.

3. Načte VSTOLoader.dll .NET Framework a spravovaná část začíná Visual Studio Tools for Office runtime.

4. Pokud je otevřen dokument z umístění místním počítačem Visual Studio Tools for Office runtime ověří, zda je umístění dokumentu v Důvěryhodných umístění seznam Nastavení Centra zabezpečení pro konkrétní aplikaci sady Office.Pokud není umístění dokumentu do důvěryhodného umístění, přizpůsobení není důvěryhodný a zastaví proces načítání zde.

5. Visual Studio Tools for Office runtime Řešení nainstaluje, 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í sady Office Solutions.

6. Pokud je vlastní nastavení důvěryhodný spustit, Visual Studio Tools for Office runtime používá aktualizací sestavení manifestu nasazení a manifestu aplikace.Pokud je k dispozici nová verze sestavení, modul runtime stáhne novou verzi sestavení ClickOnce mezipaměti v klientském počítači.Další informace naleznete v tématu Nasazení řešení Office.

7. Visual Studio Tools for Office runtime Vytvoří novou doménu aplikace, do kterého chcete načíst sestavení vlastního nastavení.

8. Visual Studio Tools for Office runtime Načte vlastní sestavení do domény aplikace.

9. Visual Studio Tools for Office runtime Volání Startup obslužné rutiny události v sestavení vašeho vlastního nastavení.Další informace naleznete v tématu Události v projektech Office

Viz také

Koncepty

Architektura doplňků úroveň aplikace

Visual Studio Tools pro přehled Runtime sady Office

Vlastní přehled vlastností dokumentu

Data v mezipaměti v úpravy na úrovni dokumentu

Další zdroje

Architektura řešení Office v aplikaci Visual Studio

Zabezpečení sady Office Solutions

Navrhování a vytváření řešení Office