Wpisy rejestrów dla dodatków na poziomie aplikacji

Artykuł
06/10/2015

Należy utworzyć pewien zbiór wpisów rejestru podczas wdrażania dodatków, które są tworzone przy użyciu Visual Studio 2013.Te wpisy rejestru Podaj informacje, które umożliwia aplikacji Microsoft Office do wyszukiwania i załadować dodatek.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie aplikacji obsługiwanych w pakietach Microsoft Office 2013 i Microsoft Office 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

Podczas tworzenia projektu, program Visual Studio tworzy tych wpisów rejestru na komputerze rozwoju, aby łatwo można uruchomić i debugowanie upthe dodatku.Jeśli używasz ClickOnce do wdrożenia dodatku, wpisy rejestru są tworzone automatycznie na komputerze użytkownika końcowego.Jeśli używasz Instalatora systemu Windows do wdrożenia dodatku, należy skonfigurować projektu InstallShield ograniczona Edition, aby utworzyć wpisy rejestru na komputerze użytkownika końcowego.

Aby uzyskać więcej informacji o sposobie używania wpisów rejestru podczas procesu ładowania dodatków, zobacz Architektura dodatków na poziomie aplikacji.

[!UWAGA]

W tym temacie tekst dodatku identyfikator reprezentuje unikatowy identyfikator dla dodatku.Domyślnie identyfikator jest nazwą zestawu dodatków.

Rejestrowanie dodatki dla vs bieżącego użytkownika.Wszyscy użytkownicy

Dodatek jest zainstalowany, może zostać zarejestrowane na dwa sposoby:

Dla bieżącego użytkownika (oznacza to, że jest dostępna tylko dla użytkownika, który jest zalogowany na komputerze jest zainstalowany dodatek).W takim przypadku wpisy rejestru są tworzone jest ustawiania w środowisku.
Dla wszystkich użytkowników (oznacza to, że każdy użytkownik, że dzienniki na komputerze, można użyć dodatku).W takim przypadku wpisy rejestru są tworzone w kluczu HKEY_LOCAL_MACHINE.

Wszystkie dodatki tworzonych przy użyciu Visual Studio 2013 można zarejestrować dla bieżącego użytkownika.Jednak można zarejestrować dodatków dla wszystkich użytkowników tylko w pewnych sytuacjach.Scenariusze te są zależne od wersji pakietu Microsoft Office na komputerze i jak wdrożenie dodatku.

Wersja pakietu Microsoft Office

Microsoft Office 2010 i Microsoft Office 2013 aplikacji można załadować dodatków, które są zarejestrowane w obszarze HKEY_LOCAL_MACHINE lub HKEY_CURRENT_USER.

Aby załadować dodatków, które są zarejestrowane w kluczu HKEY_LOCAL_MACHINE, komputery muszą mieć pakiet aktualizacji 976477 zainstalowane.Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?LinkId=184923.

Typ wdrożenia

Jeśli używasz ClickOnce wdrożyć dodatek, dodatek można zarejestrować tylko dla bieżącego użytkownika.Jest to spowodowane ClickOnce obsługuje tylko klucze tworzenia sekcji HKEY_CURRENT_USER.Jeśli chcesz zarejestrować dodatek do wszystkich użytkowników na komputerze, trzeba użyć Instalatora systemu Windows do wdrożenia dodatku.Aby uzyskać więcej informacji na temat tego typu wdrożenia zobacz Wdrażanie rozwiązania do pakietu Office przy użyciu technologii ClickOnce i Wdrażanie rozwiązania do pakietu Office przy użyciu Instalatora Windows.

Wpisy rejestru

Wymagane dodatku wpisy rejestru znajdują się w następującym kluczu rejestru dla wszystkich aplikacji, z wyjątkiem Visio, gdzie główny jest HKEY_CURRENT_USER lub HKEY_LOCAL_MACHINE.

Wszystkie aplikacje oprócz programu Visio

Wersja pakietu Office	Ścieżka konfiguracji
32-bitowa	Główny\Software\Microsoft\Office\Nazwa aplikacji\Addins\dodatku identyfikator
64-bitowe	Główny\Software\Wow6432Node\Microsoft\Office\Nazwa aplikacji\Addins\dodatku identyfikator

Visio

Wersja pakietu Office	Ścieżka konfiguracji
32-bitowa	Główny\Software\Microsoft\Visio\Addins\dodatku identyfikator
64-bitowe	Główny\Software\Wow6432Node\Visio\Addins\dodatku identyfikator

W poniższej tabeli przedstawiono wpisów w tym kluczu rejestru.

Wpis	Typ	Wartość
Description	REG_SZ	Wymagane.Krótki opis dodatku. Opis ten jest wyświetlane, gdy użytkownik wybierze dodatku w Add-Ins okienka Opcje okno dialogowe w aplikacji Microsoft Office.
FriendlyName	REG_SZ	Wymagane.Nazwy opisowej dodatek, który jest wyświetlany w COM Add-Ins okno dialogowe w aplikacji Microsoft Office.Wartość domyślna to identyfikator dodatku.
LoadBehavior	REG_DWORD	Wymagane.Wartość, która określa, kiedy aplikacja próbuje załadować dodatku i bieżący stan dodatku (załadowane lub zwolnione). Domyślnie ten wpis jest ustawiona na 3, która określa, że dodatek jest ładowany podczas uruchamiania.Aby uzyskać więcej informacji, zobacz wartości LoadBehavior. [!UWAGA] Jeśli użytkownik wyłącza dodatku, modyfikuje tej akcji LoadBehavior wartości w gałęzi rejestru HKEY_CURRENT_USER.Dla każdego użytkownika, wartość LoadBehavior wartości w gałęzi HKEY_CURRENT_USER zastępuje domyślną LoadBehavior zdefiniowanych w gałęzi HKEY_LOCAL_MACHINE.
Manifest	REG_SZ	Wymagane.Pełna ścieżka manifestu wdrażania dodatku.Ścieżka może być lokalizacji na komputerze lokalnym, w udziale sieciowym (UNC) lub serwer sieci Web (HTTP). Wdrażanie rozwiązania za pomocą Instalatora Windows, należy dodać prefiks file:/// do manifest ścieżki.Należy także dołączyć ciąg \|vstolocal (czyli znaku potoku\|po którym następuje vstolocal) na końcu tej ścieżki.Zapewnia to, że rozwiązanie jest załadowany z folderu instalacji, a nie w pamięci podręcznej technologii ClickOnce.Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania do pakietu Office przy użyciu Instalatora Windows. [!UWAGA] Podczas tworzenia dodatku na komputerze rozwoju programu Visual Studio automatycznie dołącza \|vstolocal ciąg do tego wpisu rejestru.

Wpisy rejestru dla regionów formularzy programu Outlook

Jeśli tworzysz region formularza niestandardowego w dodatek dla programu Outlook, wpisy rejestru dodatkowe są używane do rejestrowania regionu formularza z programu Outlook.Te pozycje są tworzone w kluczu rejestru różne dla każdej klasy wiadomości, która obsługuje regionu formularza.Klucze rejestru znajdują się w następującej lokalizacji, gdzie główny jest HKEY_CURRENT_USER lub HKEY_LOCAL_MACHINE.

Główny\Software\Microsoft\Office\Outlook\FormRegions\klasą wiadomości

Podobnie jak inne wpisy rejestru wspólne dla wszystkich dodatków Visual Studio tworzy formularz wpisy rejestru region na na komputerze deweloperskim podczas tworzenia projektu.Jeśli używasz ClickOnce do wdrożenia dodatku, wpisy rejestru są tworzone automatycznie na komputerze użytkownika końcowego.Jeśli używasz Instalatora systemu Windows do wdrożenia dodatku, należy skonfigurować projektu InstallShield ograniczona Edition, aby utworzyć wpisy rejestru na komputerze użytkownika końcowego.

Aby uzyskać więcej informacji dotyczących wpisów rejestru region formularza, zobacz Określanie regionów formularzy w rejestrze systemu Windows.Aby uzyskać więcej informacji na temat regionów formularzy programu Outlook, zobacz Tworzenie regionów formularzy w programie Outlook.

Wartości LoadBehavior

LoadBehavior Wpis w główny\Software\Microsoft\Office\Nazwa aplikacji\Addins\dodatku identyfikator klucz zawiera bitowe połączenie wartości określające zachowanie czas wykonywania dodatku.Najniższa bitowe kolejności (wartości 0 i 1) wskazuje, czy dodatek jest obecnie zwolnione czy załadować.Pozostałe bity wskazać, gdy aplikacja próbuje załadować dodatku.

Zazwyczaj LoadBehavior wpisu ma być równa 0, 3 lub 16 (w liczba dziesiętna) gdy dodatek został zainstalowany na komputerach użytkownika końcowego.Domyślnie ustawia programu Visual Studio LoadBehavior wpisu dodatek do 3 podczas tworzenia lub opublikuj go.

Poniższa tabela przedstawia wszystkie możliwe wartości LoadBehavior wpisu.Niektóre opisy w tej tabeli odnoszą się do ładowania dodatek ręcznie lub programistycznie.Aby załadować dodatek ręcznie, zaznacz pole wyboru obok dodatku w COM Add-Ins okno dialogowe w aplikacji.Aby załadować dodatek programistycznie, należy ustawić Connect właściwości COMAddIn obiekt, który reprezentuje dodatku do true.

Wartość (liczba dziesiętna)	Stan dodatku	Podczas ładowania dodatku	Opis
0	Zwolniono	Nie są automatycznie ładowane	Aplikacja nigdy nie próbuje załadować dodatku automatycznie.Użytkownik może próbować ręcznie załadować dodatku lub dodatku można ładować programistycznie. Jeśli dodatku została pomyślnie załadowana, LoadBehavior wartość 0 pozostaje jednak, że stan dodatku w COM Add-ins okno dialogowe jest aktualizowana w celu wskazania, że dodatek jest załadowany.
1	załadowano	Nie są automatycznie ładowane	Aplikacja nigdy nie próbuje załadować dodatku automatycznie.Użytkownik może próbować ręcznie załadować dodatku lub dodatku można ładować programistycznie. Chociaż COM Add-ins okno dialogowe wskazuje, że dodatek jest ładowany po uruchomieniu aplikacji, dodatku nie jest faktycznie załadowane do momentu załadowania go ręcznie lub programistycznie. Jeśli aplikacja pomyślnie ładuje dodatku, LoadBehavior wartość zmienia się od 0 i pozostają w 0 po zamknięciu aplikacji.
2	Zwolniono	Załaduj podczas uruchamiania	Aplikacja nie próbuje załadować dodatku automatycznie.Użytkownik może próbować ręcznie załadować dodatku lub dodatku można ładować programistycznie. Jeśli aplikacja pomyślnie ładuje dodatku, LoadBehavior wartość zmiany w 3 i pozostają w 3 po zamknięciu aplikacji.
3	załadowano	Załaduj podczas uruchamiania	Aplikacja próbuje załadować dodatku podczas uruchamiania aplikacji.Jest to wartość domyślna podczas tworzenia i publikowania dodatek w programie Visual Studio. Jeśli aplikacja pomyślnie ładuje dodatku, LoadBehavior wartość pozostaje 3.Jeśli wystąpi błąd podczas ładowania dodatku, LoadBehavior wartość zmiany w 2 i pozostają w 2 po zamknięciu aplikacji.
8	Zwolniono	Ładuj na żądanie	Aplikacja nie próbuje załadować dodatku automatycznie.Użytkownik może próbować ręcznie załadować dodatku lub dodatku można ładować programistycznie. Jeśli aplikacja pomyślnie ładuje dodatku, LoadBehavior wartość zmieni się na 9.
9	załadowano	Ładuj na żądanie	Dodatek będą ładowane tylko wtedy, gdy aplikacja wymaga, takie jak po kliknięciu elementu interfejsu użytkownika używająca funkcji w dodatku (na przykład przycisk niestandardowe na Wstążce). Jeśli aplikacja pomyślnie ładuje dodatku, LoadBehavior wartość pozostaje 9, ale stan dodatku w COM Add-ins okno dialogowe jest aktualizowana w celu wskazania, że dodatek jest obecnie załadowany.Jeśli wystąpi błąd podczas ładowania dodatku, LoadBehavior wartość zmieni się na 8.
16	załadowano	Załaduj po raz pierwszy, a następnie załadować na żądanie	Ta wartość ma dodatek do załadowania na żądanie.Dodaj do ładowania aplikacji, kiedy użytkownik uruchomi aplikację po raz pierwszy.Następnym razem, gdy użytkownik uruchomi aplikację, żadnych elementów interfejsu użytkownika, zdefiniowanych przez dodatek ładowania aplikacji, ale dodatku nie jest ładowany aż użytkownik kliknie element interfejsu użytkownika, który jest skojarzony z dodatku. Po pomyślnym ładowania aplikacji dodatku po raz pierwszy, LoadBehavior wartość będzie 16, gdy dodatek jest załadowany.Po zamknięciu aplikacji, LoadBehavior wartość zmieni się na 9.