Udostępnij za pośrednictwem

Architektura dostosowań na poziomie dokumentu

  • Artykuł

Program Visual Studio 2013 zawiera projekty służące do tworzenia dostosowań na poziomie dokumentu dla programów Microsoft Office Word i Microsoft Office Excel. W tym temacie opisano następujące aspekty dostosowań na poziomie dokumentu:

Omówienie dostosowań

Gdy używasz narzędzi deweloperskich pakietu Office w programie Visual Studio do tworzenia dostosowywania na poziomie dokumentu, należy utworzyć zarządzany zestaw kodu skojarzony z określonym dokumentem. Mówi się, że dokument lub skoroszyt z połączonym zestawem mają zarządzane rozszerzenia kodu. Aby uzyskać więcej informacji, zobacz Projektowanie i tworzenie rozwiązań pakietu Office.

Gdy użytkownik otworzy dokument, zestaw zostanie załadowany przez aplikacja pakietu Office licację firmy Microsoft. Po załadowaniu zestawu dostosowanie może reagować na zdarzenia podczas otwierania dokumentu. Dostosowanie może również wywołać model obiektów, aby zautomatyzować i rozszerzyć aplikację, gdy dokument jest otwarty, i może używać dowolnej klasy 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 użytkownik otworzy wiele dostosowań na poziomie dokumentu w tym samym czasie, każdy zestaw zostanie załadowany w innej domenie aplikacji. Oznacza to, że jedno rozwiązanie, które działa nieprawidłowo, nie może spowodować awarii innych rozwiązań. Dostosowania na poziomie dokumentu są przeznaczone do pracy z pojedynczym dokumentem w jednej domenie aplikacji. Nie są one przeznaczone do komunikacji między dokumentami. Aby uzyskać więcej informacji na temat domen aplikacji, zobacz Domeny aplikacji.

Uwaga

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

Środowiska czasu projektowania i czasu wykonywania

Aby zrozumieć architekturę dostosowań na poziomie dokumentu, pomaga zrozumieć środowiska projektowania rozwiązania i uruchamiania rozwiązania.

Czas projektowania

Środowisko czasu projektowania obejmuje następujące kroki:

  1. Deweloper tworzy projekt na poziomie dokumentu w programie Visual Studio. Projekt zawiera dokument i zestaw, który jest uruchamiany za dokumentem. Dokument może już istnieć (utworzony przez projektanta) lub można utworzyć nowy dokument wraz z projektem.

  2. Projektant — deweloper, który tworzy projekt lub kogoś innego — tworzy ostateczny wygląd i działanie dokumentu dla użytkownika końcowego.

Środowisko uruchomieniowe

Środowisko uruchomieniowe obejmuje następujące kroki:

  1. Użytkownik końcowy otwiera dokument lub skoroszyt z rozszerzeniami kodu zarządzanego.

  2. Dokument lub skoroszyt ładuje skompilowany zestaw.

  3. Zestaw reaguje na zdarzenia, gdy użytkownik pracuje w dokumencie lub skoroszycie.

Porównanie perspektywy deweloperów i użytkowników końcowych

Ponieważ deweloper działa głównie w programie Visual Studio, a użytkownik końcowy działa w programie Word lub Excel, istnieją dwa sposoby zrozumienia dostosowań na poziomie dokumentu.

Perspektywa dewelopera Perspektywa użytkownika końcowego
Za pomocą programu Visual Studio deweloper pisze kod dostępny dla programów Word i Excel.

Chociaż może się wydawać, że deweloper tworzy plik wykonywalny z uruchomionym programem Word lub Excel, proces faktycznie działa w drugą stronę. Dokument jest skojarzony z zestawem i zawiera wskaźnik do tego zestawu. Po otwarciu dokumentu program Word lub Excel lokalizuje zestaw i uruchamia kod w odpowiedzi na wszystkie obsługiwane zdarzenia.		 Ci, którzy korzystają z rozwiązania, po prostu otwierają dokument lub skoroszyt (lub tworzą nowy dokument na podstawie szablonu), tak samo jak w przypadku otwierania dowolnego innego pliku pakietu Microsoft Office.

Zestaw udostępnia dostosowania w dokumencie lub skoroszycie, takie jak automatyczne wypełnianie go bieżącymi danymi lub wyświetlanie okna dialogowego w celu żądania informacji.

Obsługiwane formaty dokumentów dla dostosowań na poziomie dokumentu

Podczas tworzenia projektu dostosowywania można wybrać format dokumentu, którego chcesz użyć w projekcie. Aby uzyskać więcej informacji, zobacz How to: Create Office projects in Visual Studio (Jak tworzyć projekty pakietu Office w programie Visual Studio).

W poniższej tabeli wymieniono formaty dokumentów, których można używać w dostosowaniach na poziomie dokumentu dla programów Excel i Word.

Excel Word
Skoroszyt programu Excel (.xlsx)

Skoroszyt z obsługą makr programu Excel (.xlsm)

Skoroszyt binarny programu Excel (.xlsb)

Skoroszyt programu Excel 97–2003 (.xls)

Szablon programu Excel (.xltx)

Szablon z obsługą makr programu Excel (.xltm)

Szablon programu Excel 97–2003 (.xlt)		 Dokument programu Word (.docx)

Dokument z obsługą makr programu Word (.docm)

Dokument programu Word 97–2003 (dokument)

Szablon programu Word (.dotx)

Szablon z obsługą makr programu Word (.dotm)

Szablon programu Word 97–2003 (dot)

Należy zaprojektować rozszerzenia kodu zarządzanego tylko dla dokumentów w obsługiwanych formatach. W przeciwnym razie niektóre zdarzenia mogą nie być zgłaszane, gdy dokument zostanie otwarty w aplikacji. Na przykład Open zdarzenie nie jest wywoływane w przypadku używania rozszerzeń kodu zarządzanego ze skoroszytami zapisanymi w formacie arkusza kalkulacyjnego XML programu Excel lub na stronie internetowej (.htm; . format html).

Obsługa dokumentów programu Word z rozszerzeniami nazw plików XML

Szablony projektów na poziomie dokumentu nie umożliwiają tworzenia projektów w oparciu o następujące formaty plików:

  • Dokument XML programu Word (*xml).

  • Dokument XML programu Word 2003 (*xml).

    Jeśli chcesz, aby użytkownicy końcowi używali dostosowań w tych formatach plików, skompiluj i wdróż dostosowanie, które używa jednego z obsługiwanych formatów plików określonych w powyższej tabeli. Po zainstalowaniu dostosowania użytkownicy końcowi mogą zapisać dokument w formacie dokumentu XML programu Word (*xml) lub w formacie dokumentu XML programu Word 2003 (*xml), a dostosowanie będzie nadal działać zgodnie z oczekiwaniami.

Składniki dostosowań

Głównymi składnikami dostosowywania są dokument i zestaw. Oprócz tych składników istnieje kilka innych części, które odgrywają ważną rolę w sposobie odnajdywania i ładowania dostosowań przez firmę Microsoft aplikacja pakietu Office lication.

Manifest wdrożenia i manifest aplikacji

Dostosowania używają manifestów wdrażania i manifestów aplikacji do identyfikowania i ładowania najnowszej wersji zestawu dostosowywania. Manifest wdrożenia wskazuje bieżący manifest aplikacji. Manifest aplikacji wskazuje zestaw dostosowywania i określa klasę punktu wejścia (lub klasy) 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ć dostosowania na poziomie dokumentu 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 Visual Studio Tools dla pakietu Office zawiera niezarządzane składniki, które ładują zestaw dostosowywania, a także zestaw zarządzanych zestawów. Te zestawy zarządzane udostępniają model obiektów używany przez kod dostosowywania do automatyzacji i rozszerzania aplikacji hosta.

Aby uzyskać więcej informacji, zobacz Omówienie narzędzi programu Visual Studio dla środowiska uruchomieniowego pakietu Office.

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

Gdy użytkownik otworzy dokument, który jest częścią dostosowywania pakietu Microsoft Office, aplikacja używa manifestu wdrożenia połączonego z dokumentem w celu zlokalizowania i załadowania najnowszej wersji zestawu dostosowywania. Lokalizacja manifestu wdrożenia jest przechowywana w niestandardowej właściwości dokumentu o nazwie AssemblyLocation. Ciąg identyfikujący tę lokalizację jest wstawiany do właściwości podczas tworzenia rozwiązania.

Manifest wdrożenia wskazuje manifest aplikacji, który następnie wskazuje na najbardziej bieżący zestaw. Aby uzyskać więcej informacji, zobacz Manifesty aplikacji i wdrażania w rozwiązaniach pakietu Office.

Poniższa ilustracja przedstawia podstawową architekturę dostosowywania na poziomie dokumentu.

2007 Office customization architecture

Uwaga

W przypadku rozwiązań pakietu Office przeznaczonych dla programu .NET Framework 4 rozwiązania są wywoływane do modelu obiektów aplikacji hosta przy użyciu podstawowych informacji o typie zestawu międzyoperacowego (PIA), które są osadzone 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

Poniższe kroki są wykonywane, gdy użytkownik otworzy dokument, który jest częścią rozwiązania pakietu Microsoft Office.

  1. Aplikacja Microsoft aplikacja pakietu Office lication sprawdza właściwości niestandardowego dokumentu, aby sprawdzić, czy istnieją rozszerzenia kodu zarządzanego skojarzone z dokumentem. Aby uzyskać więcej informacji, zobacz Omówienie właściwości dokumentów niestandardowych.

  2. Jeśli istnieją rozszerzenia kodu zarządzanego, aplikacja ładuje bibliotekę VSTOEE.dll, która ładuje bibliotekę VSTOLoader.dll. Są to niezarządzane biblioteki DLL, które są składnikami modułu ładującego dla środowiska uruchomieniowego programu Visual Studio 2010 Tools for Office. 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. Jeśli dokument zostanie otwarty z lokalizacji innej niż komputer lokalny, środowisko uruchomieniowe Visual Studio Tools dla pakietu Office sprawdza, czy lokalizacja dokumentu znajduje się na liście Zaufane lokalizacje w Centrum zaufania Ustawienia dla tej konkretnej aplikacja pakietu Office licacji. Jeśli lokalizacja dokumentu nie znajduje się w zaufanej lokalizacji, dostosowanie nie jest zaufane, a proces ładowania zatrzyma się tutaj.

  5. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office instaluje rozwiązanie, jeśli nie zostało jeszcze zainstalowane, pobiera najnowsze manifesty aplikacji i wdrażania oraz wykonuje serię kontroli zabezpieczeń. Aby uzyskać więcej informacji, zobacz Secure Office solutions (Zabezpieczanie rozwiązań pakietu Office).

  6. Jeśli dostosowanie jest zaufane do uruchomienia, środowisko uruchomieniowe Visual Studio Tools dla pakietu Office używa manifestu wdrożenia i manifestu aplikacji do sprawdzania dostępności aktualizacji zestawów. 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 można załadować zestaw dostosowywania.

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

  9. Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wywołuje program obsługi zdarzeń uruchamiania w zestawie dostosowywania. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Powiązana zawartość