Architektura dodatków narzędzi VSTO

  • Artykuł

Dodatki VSTO utworzone przy użyciu narzędzi deweloperskich pakietu Office w programie Visual Studio mają funkcje architektury, które podkreślają stabilność i bezpieczeństwo, i umożliwiają ścisłą współpracę z pakietem Microsoft Office. W tym temacie opisano następujące aspekty dodatków VSTO:

Omówienie dodatków VSTO

Gdy używasz narzędzi deweloperskich pakietu Office w programie Visual Studio do tworzenia dodatku VSTO, należy utworzyć zarządzany zestaw kodu ładowany przez aplikacja pakietu Office licację firmy Microsoft. Po załadowaniu zestawu dodatek VSTO może reagować na zdarzenia zgłaszane w aplikacji (na przykład po kliknięciu elementu menu przez użytkownika). Dodatek VSTO może również wywołać model obiektów w celu zautomatyzowania i rozszerzenia aplikacji, a także może używać dowolnych klas w programie .NET Framework.

Zestaw komunikuje się ze składnikami COM aplikacji za pośrednictwem podstawowego zestawu międzyoperacyjnego aplikacji. Aby uzyskać więcej informacji, zobacz Podstawowe zestawy międzyoperatorowe pakietu Office i Omówienie programowania rozwiązań pakietu Office (VSTO).

Jeśli dla aplikacji jest zainstalowanych wiele dodatków VSTO, każdy dodatek VSTO jest ładowany w innej domenie aplikacji. Oznacza to, że jeden dodatek VSTO, który działa nieprawidłowo, nie może spowodować awarii innych dodatków VSTO. Pomaga to również zapewnić, że po zamknięciu aplikacji wszystkie zestawy dodatków VSTO są zwalniane z pamięci. Aby uzyskać więcej informacji na temat domen aplikacji, zobacz Domeny aplikacji.

Uwaga

Dodatki VSTO tworzone przy użyciu narzędzi deweloperskich pakietu Office w programie Visual Studio są przeznaczone do użycia tylko wtedy, gdy host microsoft aplikacja pakietu Office lication jest uruchamiany przez użytkownika końcowego. Jeśli aplikacja jest uruchamiana programowo (na przykład przy użyciu usługi Automation), dodatek VSTO może nie działać zgodnie z oczekiwaniami.

Składniki dodatków VSTO

Mimo że zestaw dodatków VSTO jest głównym składnikiem, istnieje kilka innych składników, które odgrywają ważną rolę w sposobie odnajdywania i ładowania dodatków VSTO przez firmę Microsoft aplikacja pakietu Office lications.

Wpisy rejestru

Microsoft aplikacja pakietu Office lications odnajduje dodatki VSTO, wyszukując zestaw wpisów rejestru. Aby uzyskać pełną listę wpisów rejestru używanych przez dodatki VSTO, zobacz Wpisy rejestru dla dodatków VSTO.

Podczas kompilowania rozwiązania program Visual Studio tworzy wszystkie wymagane wpisy rejestru na komputerze dewelopera, aby można było debugować i uruchamiać dodatek VSTO. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

Jeśli używasz technologii ClickOnce do wdrożenia rozwiązania, program instalacyjny wygenerowany przez proces publikowania automatycznie tworzy klucze rejestru na komputerze użytkownika końcowego. Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania pakietu Office przy użyciu technologii ClickOnce.

Manifest wdrożenia i manifest aplikacji

Dodatki VSTO używają manifestów wdrażania i manifestów aplikacji do identyfikowania i ładowania najnowszej wersji zestawu dodatku VSTO. Manifest wdrożenia wskazuje bieżący manifest aplikacji. Manifest aplikacji wskazuje zestaw dodatku VSTO i określa klasę punktu wejścia do wykonania w zestawie. Aby uzyskać więcej informacji, zobacz Manifesty aplikacji i wdrażania w rozwiązaniach pakietu Office.

środowisko uruchomieniowe Visual Studio Tools dla pakietu Office

Aby uruchomić dodatki VSTO utworzone przy użyciu narzędzi deweloperskich pakietu Office w programie Visual Studio, komputery użytkowników końcowych muszą mieć zainstalowane środowisko uruchomieniowe Visual Studio Tools dla pakietu Office. Środowisko uruchomieniowe zawiera składniki niezarządzane i zestaw zarządzanych zestawów. Składniki niezarządzane ładują zestaw dodatku VSTO. Zestawy zarządzane udostępniają model obiektów używany przez dodatek VSTO do automatyzowania i rozszerzania aplikacji hosta.

Aby uzyskać więcej informacji, zobacz omówienie środowiska uruchomieniowego Visual Studio Tools dla pakietu Office.

Jak dodatki VSTO działają z aplikacja pakietu Office licacjami firmy Microsoft

Gdy użytkownik uruchamia aplikacja pakietu Office licację firmy Microsoft, aplikacja używa manifestu wdrożenia i manifestu aplikacji, aby zlokalizować i załadować najnowszą wersję zestawu dodatku VSTO. Na poniższej ilustracji przedstawiono podstawową architekturę tych dodatków VSTO.

2007 Office add-in architecture

Uwaga

W przypadku rozwiązań pakietu Office przeznaczonych dla platformy .NET Framework 4 lub .NET Framework 4.5 rozwiązania są wywoływane do modelu obiektów aplikacji hosta przy użyciu informacji o typie PIA osadzonych w zestawie rozwiązania, zamiast bezpośrednio wywoływać dane OSOBOWE. Aby uzyskać więcej informacji, zobacz Projektowanie i tworzenie rozwiązań pakietu Office.

Proces ładowania

Podczas uruchamiania aplikacji przez użytkownika są wykonywane następujące kroki:

  1. Aplikacja sprawdza rejestr wpisów identyfikujących dodatki VSTO utworzone przy użyciu narzędzi deweloperskich pakietu Office w programie Visual Studio.

  2. Jeśli aplikacja znajdzie te wpisy rejestru, aplikacja ładuje plik VSTOEE.dll, który ładuje bibliotekę VSTOLoader.dll. Są to niezarządzane biblioteki DLL, które są składnikami modułu ładującego dla programu Visual Studio 2010 Tools for Office Runtime. Aby uzyskać więcej informacji, zobacz omówienie środowiska uruchomieniowego Visual Studio Tools dla pakietu Office.

  3. Biblioteka VSTOLoader.dll ładuje program .NET Framework i uruchamia zarządzaną część środowiska uruchomieniowego Visual Studio Tools dla pakietu Office .

  4. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office sprawdza dostępność aktualizacji manifestu i pobiera najnowsze manifesty aplikacji i wdrożenia.

  5. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wykonuje serię kontroli zabezpieczeń. Aby uzyskać więcej informacji, zobacz Secure Office solutions (Zabezpieczanie rozwiązań pakietu Office).

  6. Jeśli dodatek VSTO jest zaufany do uruchomienia, środowisko uruchomieniowe Visual Studio Tools dla pakietu Office używa manifestu wdrożenia i manifestu aplikacji, aby sprawdzić dostępność aktualizacji zestawu. Jeśli jest dostępna nowa wersja zestawu, środowisko uruchomieniowe pobiera nową wersję zestawu do pamięci podręcznej ClickOnce na komputerze klienckim. Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania pakietu Office.

  7. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office tworzy nową domenę aplikacji, w której ma zostać załadowany zestaw dodatku VSTO.

  8. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office ładuje zestaw dodatku VSTO do domeny aplikacji.

  9. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wywołuje metodę RequestComAddInAutomationService w dodatku VSTO, jeśli został on zastąpiony.

    Opcjonalnie można zastąpić tę metodę, aby uwidocznić obiekt w dodatku VSTO do innych rozwiązań pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Call code in VSTO Add-ins from other Office solutions (Wywoływanie kodu w dodatku VSTO z innych rozwiązań pakietu Office).

  10. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wywołuje metodę RequestService w dodatku VSTO, jeśli został on zastąpiony.

    Opcjonalnie można zastąpić tę metodę, aby rozszerzyć funkcję pakietu Microsoft Office, zwracając obiekt implementujący interfejs rozszerzalności. Aby uzyskać więcej informacji, zobacz Dostosowywanie funkcji interfejsu użytkownika przy użyciu interfejsów rozszerzalności.

    Uwaga

    Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wykonuje oddzielne wywołania RequestService metody dla każdego interfejsu rozszerzalności obsługiwanego przez aplikację hosta. Chociaż pierwsze wywołanie RequestService metody zwykle występuje przed wywołaniem ThisAddIn_Startup metody, dodatek VSTO nie powinien zawierać żadnych założeń dotyczących RequestService wywołania metody lub liczby wywołań metody.

  11. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wywołuje metodę ThisAddIn_Startup w dodatku VSTO. Ta metoda jest domyślną procedurą obsługi zdarzeń dla Startup zdarzenia. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Powiązana zawartość