Architektura dostosowywania na poziomie dokumentu
Visual Studio 2013obejmuje projekty do tworzenia dostosowań poziomie dokumentu dla programu Microsoft Office Word i Microsoft Office Excel.W tym temacie opisano następujące aspekty dostosowań na poziomie dokumentu:
Opis dostosowań
Składniki dostosowań
Jak działają dostosowań z aplikacji Microsoft Office
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu dla następujących aplikacji: Excel 2013 i Excel 2010; Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.
Aby uzyskać ogólne informacje dotyczące tworzenia dostosowań na poziomie dokumentu, zobacz Rozwój rozwiązań Office ― Omówienie, Wprowadzenie do programowania dostosowań na poziomie dokumentu dla programu Word, i Wprowadzenie do programowania dostosowań na poziomie dokumentu dla programu Excel.
Opis dostosowań
Gdy używasz narzędzia dewelopera pakietu Office w programie Visual Studio zbudować dostosowywania poziomie dokumentu, tworzenie zestawu kodu zarządzanego, który jest skojarzony z określonego dokumentu.Dokument lub skoroszyt z zestawu połączonych mówi się udało kod rozszerzenia.Aby uzyskać więcej informacji, zobacz Projektowanie i tworzenie rozwiązań Office.
Gdy użytkownik otwiera dokument, zgromadzenie jest ładowany przez aplikację Microsoft Office.Po zgromadzeniu jest ładowany, dostosowanie może reagować na zdarzenia podczas, gdy dokument jest otwarty.Dostosowania można również wywołać w modelu obiektów automatyzacji i rozszerzyć stosowanie, gdy dokument jest otwarty i może używać żadnej z klas w .NET Framework.
Zgromadzenie komunikuje się z aplikacji składników COM przez podstawowy zestaw międzyoperacyjny aplikacji.Aby uzyskać więcej informacji, zobacz Podstawowe zestawy międzyoperacyjne pakietu Office i Rozwój rozwiązań Office ― Omówienie.
Jeśli użytkownik otwiera wiele dostosowań poziomie dokumentu w tym samym czasie, każdy zestaw jest załadowany w domenie innej aplikacji.Oznacza to, że jedno rozwiązanie, które zachowuje się niepoprawnie nie może powodować inne rozwiązania nie powiedzie się.Dostosowania poziomu dokumentu są przeznaczone do pracy z jednolitego dokumentu w domenie pojedynczej aplikacji.Nie są one przeznaczone do komunikacji pomiędzy dokumentami.Aby uzyskać więcej informacji o domenach aplikacji, zobacz Domeny aplikacji.
[!UWAGA]
Dostosowania poziomie dokumentów utworzonych za pomocą narzędzia dewelopera pakietu Office w programie Visual Studio mają być używane tylko wtedy, gdy aplikacja jest uruchomiona przez użytkownika końcowego.Jeśli aplikacja jest uruchomiona programowo, na przykład przez użycie automatyzacji, dostosowanie może nie działać zgodnie z oczekiwaniami.
Doświadczenia projektowania i czas wykonywania
Aby zrozumieć architektura dostosowań na poziomie dokumentu, pomaga zrozumieć doświadczenia Projektowanie rozwiązania i systemem rozwiązania.
Czas projektowania
Doświadczenie projektowania obejmuje następujące kroki:
Deweloper tworzy projekt poziomie dokumentu w Visual Studio.Projekt obejmuje dokumentu i zestawu, który jest uruchamiany za dokument.Dokument może być już istnieje (może być utworzona przez projektanta) lub może być utworzony nowy dokument wraz z projektu.
Projektant — albo Deweloper, który tworzy projekt lub inna osoba — tworzy końcowy wygląd dokumentu dla użytkownika końcowego.
Czas jednostkowy
Doświadczenie wykonywania obejmuje następujące kroki:
Użytkownik otwiera dokument lub skoroszyt, który ma zarządzany kod rozszerzenia.
Dokument lub skoroszyt ładuje skompilowanym zestawie.
Zgromadzenie reaguje na zdarzenia, jak użytkownik pracuje w dokumencie lub skoroszycie.
Developer i porównaniu widzenia użytkownika końcowego
Ponieważ Deweloper działa przede wszystkim w Visual Studioi użytkownik pracuje w programie Word lub Excel, istnieją dwa sposoby rozumienia dostosowań na poziomie dokumentu.
Perspektywy programisty |
Perspektywy użytkownika końcowego |
|---|---|
Za pomocą Visual Studio, autora pisze kod, który jest dostępny dla programów Word i Excel. Chociaż może się wydawać, że deweloper tworzy plik wykonywalny, który uruchamia program Word lub Excel, proces faktycznie działa na odwrót.Ten dokument jest skojarzony z zestawu i zawiera wskaźnik do tego zestawu.Po otwarciu dokumentu, program Word lub Excel lokalizuje Zgromadzenie i uruchamia kod w odpowiedzi na wszystkie zdarzenia poddane obróbce. |
Tych, którzy używają roztwór po prostu otworzyć dokument lub skoroszyt (lub utworzyć nowy dokument z szablonu) tak jak byłyby otwierają dowolnego innego pliku programu Microsoft Office. Zestaw zawiera dostosowania w dokumencie lub skoroszycie, takich jak automatyczne wypełnianie bieżącymi danymi lub wyświetlono okno dialogowe do żądania informacji. |
Obsługiwane formaty dokumentów dla dostosowania poziomu dokumentu
Podczas tworzenia projektu dostosowania, można wybrać format dokumentu, którego chcesz używać w projekcie.Aby uzyskać więcej informacji, zobacz Porady: tworzenie projektów Office w Visual Studio.
Poniższa tabela zawiera listę formatów dokumentów, używanych w dostosowania poziomie dokumentu dla programu Excel i Word.
Program Excel |
Program Word |
|---|---|
Skoroszyt programu Excel (xslx) Skoroszyt programu Excel z włączoną obsługą makr (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 programu Word z włączoną obsługą makr (docm) Dokument programu Word 97–2003 (.doc) Szablon programu Word (dotx) Szablon programu Word z włączoną obsługą makr (dotm) Szablon programu Word 97-2003 (dot) |
Należy zaprojektować rozszerzenia kod zarządzany jedynie w przypadku dokumentów w obsługiwanych formatach.W przeciwnym razie niektóre zdarzenia nie może być wywoływane, gdy dokument zostanie otwarty w aplikacji.Na przykład Open zdarzenie nie jest wywoływane, gdy używasz rozszerzenia kod zarządzany przy skoroszyty zapisane w formacie arkusza kalkulacyjnego XML programu Excel lub strony sieci web (.htm; format HTML).
Wsparcie dla dokumentów programu Word, które mają rozszerzenia nazw plików XML
Szablony projektów na poziomie dokumentu nie pozwalają tworzyć projekty oparte na następujących formatów plików:
Dokument XML programu Word (* xml).
Dokument XML programu Word 2003 (* xml).
Jeśli chcesz użytkowników końcowych, aby użyć dostosowań w tych formatach plików, tworzenie oraz rozmieszczanie dostosowania, który używa jednego z obsługiwanych formatów plików określony w powyższej tabeli.Po zainstalowaniu dostosowania, użytkownicy końcowi mogą zapisać dokument w dokument XML programu Word (* xml) format lub dokument XML programu Word 2003 (* xml) format i dostosowanie będą nadal działać zgodnie z oczekiwaniami.
Składniki dostosowań
Główne składniki pliku dostosowań są dokumentu i zgromadzenie.Oprócz tych składników istnieje kilka innych części, które odgrywają istotną rolę w sposób Odkryj aplikacje Microsoft Office i pobrać dostosowań.
Manifest rozmieszczania i Manifest aplikacji
Dostosowania używać manifestów wdrażania i manifesty aplikacji do identyfikowania i załadować najbardziej aktualną wersję zestawu dostosowywania.Wdrażanie manifestu punkty do bieżącego manifest aplikacji.Aplikacja manifest punktów do zgromadzenia dostosowywania i Określa wpis punkt klasy (lub klas) do wykonania w zestawie.Aby uzyskać więcej informacji, zobacz Aplikacje i manifesty wdrożenia w rozwiązaniach pakietu Office.
Visual Studio Tools for Office Runtime
Aby uruchomić dostosowań poziomie dokumentu, które zostały utworzone przy użyciu narzędzia dewelopera pakietu Office w programie Visual Studio, użytkownik końcowy komputery muszą mieć Visual Studio Tools for Office Runtime zainstalowane.Visual Studio Tools for Office Runtime Obejmuje niezarządzane składniki, które załadować zestawu dostosowywania i zestaw zarządzanych zestawów.Zespoły te zarządzane zapewniają model obiektu, którego kod dostosowywania używa do zautomatyzowania i rozszerzanie aplikacji hosta.
Aby uzyskać więcej informacji, zobacz Visual Studio Tools for Office Runtime ― Przegląd.
Jak dostosowania pracy z aplikacjami pakietu Microsoft Office
Gdy użytkownik otwiera dokument, który jest częścią dostosowywania programu Microsoft Office, aplikacja używa połączonego z dokumentu do zlokalizowania i załadować najbardziej aktualną wersję zestawu dostosowywania manifestu wdrażania.Lokalizacja manifestu wdrażania jest przechowywana we właściwości niestandardowe dokumentu o nazwie _AssemblyLocation.Ciąg, który identyfikuje tej lokalizacji jest wstawiany do właściwości podczas tworzenia rozwiązania.
Punkty manifestu wdrażania do manifest aplikacji, który następnie punkty najnowsze zgromadzeniem.Aby uzyskać więcej informacji, zobacz Aplikacje i manifesty wdrożenia w rozwiązaniach pakietu Office.
Na poniższej ilustracji przedstawiono podstawowe architektury dostosowania poziomu dokumentu.
Architektura dostosowywania
.png "Architektura dostosowywania pakietu office 2007")
[!UWAGA]
W rozwiązaniach pakietu Office, które Program .NET Framework 4, rozwiązania wywołanie do modelu obiektu aplikacji hosta przez przy użyciu informacje o typie podstawowy zestaw międzyoperacyjny (PIA), który jest osadzony w zestawie rozwiązanie zamiast telefonicznej do PIA bezpośrednio.Aby uzyskać więcej informacji, zobacz Projektowanie i tworzenie rozwiązań Office.
Proces ładowania
Gdy użytkownik otwiera dokument, który jest częścią rozwiązania Microsoft Office, wykonywane są następujące kroki.
Aplikacja Microsoft Office sprawdza właściwości dokumentu niestandardowego do sprawdzenia, czy są skojarzone z dokumentem rozszerzenia kodu zarządzanego.Aby uzyskać więcej informacji, zobacz Niestandardowe właściwości dokumentu ― Omówienie.
Jeśli istnieją rozszerzenia kodu zarządzanego, VSTOEE.dll, która ładuje VSTOLoader.dll ładowania aplikacji.Są one zarządzane biblioteki dll, które są składnikami programu ładującego dla Visual Studio 2010 Tools for Office Runtime.Aby uzyskać więcej informacji, zobacz Visual Studio Tools for Office Runtime ― Przegląd.
Ładuje VSTOLoader.dll .NET Framework i uruchamia zarządzanych część Visual Studio Tools for Office Runtime.
Jeśli dokument został otwarty z innej lokalizacji niż komputer lokalny, Visual Studio Tools for Office Runtime sprawdza, czy lokalizacja dokumentu jest w Zaufane lokalizacje lista w Ustawienia Centrum zaufania dla danej aplikacji pakietu Office.Jeśli lokalizacja dokumentu nie jest w zaufanej lokalizacji, dostosowanie nie jest zaufany, a kończy się proces ładowania.
Visual Studio Tools for Office Runtime Instaluje rozwiązanie, jeśli nie został jeszcze zainstalowany, pliki do pobrania najnowszych manifesty aplikacji i wdrażania i wykonuje szereg kontroli bezpieczeństwa.Aby uzyskać więcej informacji, zobacz Zabezpieczanie rozwiązań pakietu Office.
Jeśli dostosowanie jest zaufany do uruchomienia, Visual Studio Tools for Office Runtime używa manifest wdrażania i manifest aplikacji, aby sprawdzić dostępność aktualizacji zestawu.Jeśli dostępna jest nowa wersja zestawu, środowisko wykonawcze pobiera nową wersję zestawu do ClickOnce pamięci podręcznej na komputerze klienckim.Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania do pakietu Office.
Visual Studio Tools for Office Runtime Powoduje utworzenie nowej domeny aplikacji, w którym chcesz załadować zestawu dostosowywania.
Visual Studio Tools for Office Runtime Ładuje zestawu dostosowania do domeny aplikacji.
Visual Studio Tools for Office Runtime Wywołania Startup programu obsługi zdarzeń w zestawie swoje dostosowania.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.
Zobacz też
Koncepcje
Architektura dodatków na poziomie aplikacji
Visual Studio Tools for Office Runtime ― Przegląd
Niestandardowe właściwości dokumentu ― Omówienie
Dane z pamięci podręcznej dostosowywane na poziomie dokumentu
Inne zasoby
Architektura rozwiązań pakietu Office w Visual Studio