Architektura dostosowań na poziomie dokumentu

Visual Studio 2012obejmuje projekty do dostosowania poziomie dokumentu dla programu Microsoft Office Word i Microsoft Office Excel.W tym temacie opisano następujące aspekty dostosowań na poziomie dokumentu:

• Zrozumienie dostosowań

• Składniki dostosowań

• Jak dostosowania pracy z aplikacjami Microsoft Office

Dotyczy: Informacje przedstawione w tym temacie dotyczą 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 aplikacji pakietu Office i typ projektu.

Ogólne informacje na temat tworzenia dostosowań na poziomie dokumentu, zobacz Przegląd rozwoju rozwiązań pakietu Office, Wprowadzenie dostosowań poziomie dokumentów programowania w programie Word, i Wprowadzenie dostosowań poziomie dokumentów programowania dla programu Excel.

Zrozumienie dostosowań

Gdy używasz Office developer tools w Visual Studio zbudować dostosowania poziomu dokumentu, tworzenia 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ń pakietu Office.

Gdy użytkownik otwiera dokument, zgromadzenie jest ładowany przez aplikację Microsoft Office.Po zgromadzeniu jest załadowany, dostosowania można reagowania na zdarzenia, gdy dokument jest otwarty.Dostosowania można również wywołać w modelu obiektów automatyzacji i rozszerzenie stosowania, podczas 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 Przegląd rozwoju rozwiązań pakietu Office.

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óra działa niepoprawnie, nie może spowodować 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 Domen aplikacji.

[!UWAGA]

Dostosowania poziomu dokumentu, tworzonych 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 w sposób programowy, na przykład przy użyciu automatyzacji, dostosowanie może nie działać zgodnie z oczekiwaniami.

W czasie projektowania i doświadczeń w czasie wykonywania

Zrozumienie architektury dostosowań na poziomie dokumentu, pomaga zrozumieć doświadczenia, projektując rozwiązanie i systemem rozwiązania.

Czas projektowania

Doświadczenie projektowania obejmuje następujące kroki:

1. Programista tworzy projekt poziomie dokumentu, w Visual Studio.Projekt zawiera dokument i zestaw, który jest uruchamiany za dokument.Dokument może być już istnieje (być może utworzona przez projektanta) lub nowy dokument można tworzyć wraz z projektem.

2. Projektant — albo Deweloper, który tworzy projekt lub inna osoba — tworzy końcowy wygląd dokumentu przez użytkownika końcowego.

Czas jednostkowy

Doświadczenie wykonywania obejmuje następujące kroki:

1. Użytkownik otwiera dokument lub skoroszyt, który ma zarządzany kod rozszerzenia.

2. Ładuje skompilowanym zestawie, dokumencie lub skoroszycie.

3. Zgromadzenie reaguje na zdarzenia, jak użytkownik pracuje w dokumencie lub skoroszycie.

Deweloper i porównaniu widzenia użytkownika końcowego

Ponieważ deweloperów pracuje przede wszystkim w Visual Studioi użytkownik pracuje w programie Word lub Excel, istnieją dwa sposoby rozumienia dostosowań na poziomie dokumentu.

Perspektywy dla deweloperów

Punktu widzenia 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.Dokument jest skojarzony z zestawu i zawiera wskaźnik do montażu.Po otwarciu dokumentu, program Word lub Excel lokalizuje Zgromadzenia i uruchamia kod w odpowiedzi na wszystkie zdarzenia poddane obróbce.

Tych, którzy używają rozwiązanie po prostu otworzyć dokument lub skoroszyt (lub utworzyć nowy dokument z szablonu) tylko otwierają się inne pliki programu Microsoft Office. Zestaw zawiera dostosowania w dokumencie lub skoroszycie, takich jak automatyczne wypełnianie danych w bieżącej lub wyświetlone okno dialogowe żądania informacji.

Obsługiwane formaty dokumentów dla dostosowania poziomu dokumentu

Podczas tworzenia projektu dostosowania, można wybrać format dokumentu, który chcesz użyć w projekcie.Aby uzyskać więcej informacji, zobacz Jak: tworzenie projektów pakietu Office w programie Visual Studio.

Poniższa tabela zawiera listę formatów dokumentów, można użyć w dostosowania poziomie dokumentu dla programu Excel i Word.

Program Excel	Program Word
Skoroszyt programu Excel (xslx) Excel skoroszyt z 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 z włączoną obsługą makr programu Word (docm) Dokument programu Word 97–2003 (.doc) 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 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 podczas korzystania z rozszerzenia kod zarządzany z skoroszyty zapisane w formacie arkusza kalkulacyjnego XML programu Excel lub na stronie sieci web (.htm; format HTML).

Wsparcie dla dokumentów programu Word, które mają .xml rozszerzeń nazw plików

Szablony projektów na poziomie dokumentu nie pozwalają na tworzenie projektów w następujących formatach:

• Dokument XML programu Word (* xml).

• Dokument XML programu Word 2003 (* xml).

Jeśli użytkowników końcowych i używać dostosowań w tych formatach plików, budowania i wdrożyć dostosowywania, który używa jednego z obsługiwanych formatów plików określone w powyższej tabeli.Po zainstalowaniu dostosowywania, użytkowników końcowych można zapisać dokumentu w dokumencie XML programu Word (* xml) format lub dokument XML programu Word 2003 (* xml) format i dostosowywania będą nadal działać zgodnie z oczekiwaniami.

Składniki dostosowań

Główne składniki dostosowań są dokumentu i zgromadzenie.Oprócz tych składników istnieje kilka innych części, które odgrywają ważną rolę w jak odkryć i pobrać dostosowań w aplikacji Microsoft Office.

Manifest wdrożenia i Manifest aplikacji

Dostosowania używać manifestów wdrażania i manifesty aplikacji do identyfikowania i załadować najnowszą wersję zestawu dostosowywania.Wdrażanie manifestu punktów do bieżącego manifest aplikacji.Aplikacja manifest punktów do zgromadzenia dostosowywania i Określa wpis punkt klasy (lub klas) wykonać w zestawie.Aby uzyskać więcej informacji, zobacz Aplikacja i manifestów wdrażania rozwiązań pakietu Office.

Visual Studio Tools for Office Runtime

Aby uruchomić dostosowania poziomu dokumentu, które są tworzone za pomocą narzędzia dewelopera pakietu Office w programie Visual Studio, użytkownik końcowy komputery muszą mieć Visual Studio 2010 Tools for Office Runtime zainstalowane.Visual Studio 2010 Tools for Office Runtime Obejmuje niezarządzane składniki, które załadować zestawu dostosowywania i zestaw zestawów zarządzanych.Tych zestawów zarządzanych zapewniają model obiektu, którego kod dostosowywania używa do automatyzacji i rozszerzanie aplikacji hosta.

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

Jak dostosowania pracy z aplikacjami pakietu Microsoft Office

Gdy użytkownik otwiera dokument, który jest częścią dostosowywania programu Microsoft Office, aplikacja wykorzystuje manifest wdrożenia połączonego z dokumentu, aby znaleźć i załadować najnowszą wersję zestawu dostosowywania.Lokalizacja manifestu wdrażania jest przechowywana w właściwości niestandardowych dokumentu o nazwie _AssemblyLocation.Ciąg, który identyfikuje tę lokalizację dodaje się do właściwości podczas tworzenia rozwiązania.

Punkty manifestu wdrażania się manifest aplikacji, która następnie wskazuje na najbardziej bieżącego zestawu.Aby uzyskać więcej informacji, zobacz Aplikacja i manifestów wdrażania rozwiązań pakietu Office.

Na poniższej ilustracji przedstawiono podstawową architekturę dostosowywania poziomie dokumentu.

Architektura dostosowywania

[!UWAGA]

W rozwiązaniach pakietu Office, które .NET Framework 4, rozwiązania zadzwonić do modelu aplikacji hosta przez przy użyciu informacji typ podstawowy zestaw międzyoperacyjny (PIA) jest osadzony w zestawie rozwiązanie zamiast kwestionowania PIA bezpośrednio.Aby uzyskać więcej informacji, zobacz Projektowanie i tworzenie rozwiązań pakietu Office.

Proces ładowania

Gdy użytkownik otwiera dokument, który jest częścią rozwiązania Microsoft Office są wykonywane następujące kroki.

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

2. W przypadku rozszerzenia kodu zarządzanego, VSTOEE.dll, który ładuje VSTOLoader.dll ładowania aplikacji.Są niezarządzane pliki 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 dla pakietu Office, omówienie Runtime.

3. Ładuje VSTOLoader.dll .NET Framework i uruchamiania zarządzanych część Visual Studio 2010 Tools for Office Runtime.

4. Jeśli dokument został otwarty z lokalizacji innej niż komputer lokalny, Visual Studio 2010 Tools for Office Runtime sprawdza, czy lokalizacja dokumentu jest w Zaufane lokalizacje lista w Ustawienia Centrum zaufania dla tej określonej aplikacji pakietu Office.Jeśli lokalizacja dokumentu nie jest w zaufanej lokalizacji, dostosowanie nie jest zaufany i kończy się procesu ładowania.

5. Visual Studio 2010 Tools for Office Runtime Instaluje rozwiązanie, jeśli nie został jeszcze zainstalowany, pliki do pobrania najnowszych manifestów, stosowania i wdrażania i wykonuje szereg kontroli bezpieczeństwa.Aby uzyskać więcej informacji, zobacz Zabezpieczanie rozwiązań pakietu Office.

6. Jeśli dostosowanie są zaufane, aby uruchomić, Visual Studio 2010 Tools for Office Runtime używa manifestu wdrażania i manifest aplikacji Aby sprawdzić, czy są aktualizacje zestawu.Jeśli dostępna jest nowa wersja zestawu, runtime 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.

7. Visual Studio 2010 Tools for Office Runtime Powoduje utworzenie nowej domeny aplikacji, w którym ładowania zestawu dostosowywania.

8. Visual Studio 2010 Tools for Office Runtime Ładuje montaż dostosowywania do domeny aplikacji.

9. Visual Studio 2010 Tools for Office Runtime Wywołania Startup obsługi zdarzeń w zestawie swoje dostosowywania.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Zobacz też

Koncepcje

Architektura dodatków poziomie aplikacji

Visual Studio Tools dla pakietu Office, omówienie Runtime

Omówienie właściwości dokumentu niestandardowego

Buforowane dane w dokumencie poziom dostosowania

Inne zasoby

Architektura rozwiązania dla pakietu Office w programie Visual Studio

Zabezpieczanie rozwiązań pakietu Office

Projektowanie i tworzenie rozwiązań pakietu Office