Wpisy rejestru na poziomie aplikacji dodatki

Artykuł
02/27/2013

Określony zestaw wpisów rejestru należy utworzyć podczas wdrażania dodatków, które są tworzone za pomocą Visual Studio 2012.Te wpisy rejestru zawierają informacje, który umożliwia aplikacji Microsoft Office odkryć i załadować dodatek.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie aplikacji dla pakietu Microsoft Office 2013 i Microsoft Office 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu

Podczas tworzenia projektu Visual Studio utworzy tych wpisów rejestru na komputerze deweloperskim, tak, aby łatwo można uruchomić i debugowania dodatku.Jeśli używasz ClickOnce wdrażania dodatku, wpisy rejestru są tworzone automatycznie na komputerze użytkownika końcowego.Jeśli Instalator Windows umożliwia wdrażanie dodatku, należy skonfigurować projekt InstallShield Limited Edition, aby utworzyć wpisy rejestru na komputerze użytkownika końcowego.

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

[!UWAGA]

W tym temacie, tekst dodatek ID reprezentuje unikatowy identyfikator dodatku.Domyślnie identyfikator jest zestawem dodatek nazwę.

Rejestrowanie dodatków dla bieżącego użytkownika VS. wszystkich użytkowników

Gdy dodatek jest zainstalowany, mogą być rejestrowane na dwa sposoby:

Tylko dla bieżącego użytkownika (to znaczy jest dostępne tylko dla użytkownika, który jest zalogowany na komputerze jest zainstalowany dodatek).W takim przypadku wpisy rejestru są tworzone w sekcji HKEY_CURRENT_USER.
Dla wszystkich użytkowników (to znaczy dowolnego użytkownika że dzienniki na komputerze można używać dodatku).W takim przypadku wpisy rejestru są tworzone w kluczu HKEY_LOCAL_MACHINE.

Wszystkie dodatki tworzonych za pomocą Visual Studio 2012 mogą być rejestrowane dla bieżącego użytkownika.Jednakże dodatki mogą być rejestrowane dla wszystkich użytkowników tylko w niektórych scenariuszach.Scenariusze te zależą od wersji pakietu Microsoft Office na komputerze i jak wdrożyć dodatek.

Wersja pakietu Microsoft Office

Microsoft Office 2010 i Microsoft Office 2013 aplikacje można ładować dodatki zrejestrowane w kluczu HKEY_LOCAL_MACHINE lub HKEY_CURRENT_USER.

Aby załadować dodatki zrejestrowane 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 wdrażania

Jeśli używasz ClickOnce Aby wdrożyć dodatek dodatek można rejestrować tylko dla bieżącego użytkownika.Wynika to z ClickOnce obsługuje tylko tworzenie kluczy w sekcji HKEY_CURRENT_USER.Jeśli chcesz zarejestrować dodatek dla wszystkich użytkowników na komputerze, należy użyć Instalator Windows, aby wdrożyć dodatek.Aby uzyskać więcej informacji o tych typach wdrażania, 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 dodatek wpisy rejestru znajdują się w następującym kluczu rejestru dla wszystkich aplikacji, z wyjątkiem programu Visio, gdzie główny jest HKEY_CURRENT_USER lub HKEY_LOCAL_MACHINE.

Główny\Software\Microsoft\Office\Nazwa aplikacji\Addins\dodatek ID

Wpisy rejestru dla programu Visio, należą do sekcji następujący klucz rejestru.

Główny\Software\Microsoft\Visio\Addins\dodatek ID

Poniższa lista zawiera wpisy w tym kluczu rejestru.

Wpis	Typ	Wartość
Description	REG_SZ	Wymagane.Krótki opis dodatek. Opis ten jest wyświetlany, gdy użytkownik wybierze dodatek w Add-Ins okienko z Opcje okno dialogowe w aplikacji Microsoft Office.
FriendlyName	REG_SZ	Wymagane.Opisową nazwę dodatku, 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ć dodatek i bieżącemu stanowi dodatek (załadunku lub rozładunku). 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.
Manifest	REG_SZ	Wymagane.Pełna ścieżka manifestu wdrażania dla dodatku.Ścieżka może być lokalizacja na komputerze lokalnym, dysku sieciowym (UNC) lub serwer sieci Web (HTTP). Jeśli używasz Instalator Windows Wdrożenie tego rozwiązania, należy dodać przedrostek file:/// do manifest ścieżki.Należy również dołączyć ciąg \|vstolocal (to znaczy znaku potoku\|następuje vstolocal) na końcu tej ścieżki.Gwarantuje to, że rozwiązanie jest ładowany z folderu instalacji, a nie w pamięci podręcznej ClickOnce.Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania do pakietu Office przy użyciu Instalatora Windows. Uwaga Podczas tworzenia dodatku programu na komputerze deweloperskim, Visual Studio automatycznie dołącza \|vstolocal ciąg, aby ten wpis rejestru.
Warmup	REG_DWORD	Opcjonalne.Wartość, która wskazuje, że.NET Framework i Visual Studio 2010 Tools for Office Runtime wczytana ładunków add-in oraz skróceniu czasu postrzegane załadować dodatek.Ustaw Warmup wpis na 1 i używać go w połączeniu z LoadBehavior wpis w celu skrócenia czasu obciążenia dla programu Outlook 2010 i Outlook 2013 dodatków, które są wdrażane za pomocą Instalator Windows (.msi).Ten klucz rejestru nie można ustawić przy użyciu technologii ClickOnce.

Wpisy rejestru dla regionów formularzy programu Outlook

Po utworzeniu regionu formularza niestandardowego w dodatek dla programu Outlook, wpisy rejestru dodatkowe są używane do rejestrowania region formularza z programem Outlook.Wpisy te są tworzone w kluczu rejestru różne dla każdej klasy wiadomości, który obsługuje regionu formularza.Te klucze rejestru znajdują się w poniższej lokalizacji, gdzie główny jest HKEY_CURRENT_USER lub HKEY_LOCAL_MACHINE.

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

Podobnie jak inne wpisy rejestru współużytkowane przez wszystkie dodatki Visual Studio tworzy formularz regionu wpisy rejestru na komputerze deweloperskim podczas tworzenia projektu.Jeśli używasz ClickOnce wdrażania dodatku, wpisy rejestru są tworzone automatycznie na komputerze użytkownika końcowego.Jeśli Instalator Windows umożliwia wdrażanie dodatku, należy skonfigurować projekt InstallShield Limited Edition, aby utworzyć wpisy rejestru na komputerze użytkownika końcowego.

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

Wartości LoadBehavior

LoadBehavior w poniżej główny\Software\Microsoft\Office\Nazwa aplikacji\Addins\dodatek ID klucz zawiera bitowe łączenie wartości określające zachowanie czas jednostkowy dodatek.Najniższy bit zamówienia (wartość 0 i 1) wskazuje, czy dodatek jest obecnie rozładowane lub załadowany.Inne kawałki wskazują, gdy aplikacja próbuje załadować dodatek.

Zazwyczaj LoadBehavior wpis ma na celu być równa 0, 3 lub 16 (w zapisie dziesiętnym) gdy dodatek jest zainstalowany na komputerach użytkownika końcowego.Domyślnie ustawia Visual Studio LoadBehavior wpisu usuwających dodatek 3 podczas tworzenia lub opublikować go.

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

Wartość (w zapisie dziesiętnym)	Stan-dodatek	Podczas ładowania dodatku	Opis
0	Rozładowane	Nie są ładowane automatycznie	Aplikacja nigdy nie jest podejmowana próba załadowania dodatku automatycznie.Użytkownika można spróbować ręcznie załadować dodatek lub dodatek może być załadowany programowo. Jeśli dodatek jest załadowany pomyślnie, LoadBehavior wartość pozostaje 0, ale stan dodatek w Dodatki COM okno dialogowe jest aktualizowany, aby wskazać, że dodatek jest załadowany.
1	Załadowane	Nie są ładowane automatycznie	Aplikacja nigdy nie jest podejmowana próba załadowania dodatku automatycznie.Użytkownika można spróbować ręcznie załadować dodatek lub dodatek może być załadowany programowo. Chociaż Dodatki COM okno dialogowe wskazuje, że dodatek jest załadowany po uruchomieniu aplikacji, dodatek jest faktycznie załadowana, dopóki nie jest załadowany, ręcznie lub programowo. Jeśli aplikacja pomyślnie ładuje dodatek, LoadBehavior wartość zmienia się od 0 i pozostaje na 0, po zamknięciu aplikacji.
2	Rozładowane	Ładuj przy Autostarcie	Aplikacja nie próbuje załadować dodatek automatycznie.Użytkownika można spróbować ręcznie załadować dodatek lub dodatek może być załadowany programowo. Jeśli aplikacja pomyślnie ładuje dodatek, LoadBehavior wartość zmienia się na 3 i pozostaje w pkt 3, po zamknięciu aplikacji.
3	Załadowane	Ładuj przy Autostarcie	Aplikacja próbuje załadować dodatek, podczas uruchamiania aplikacji.Jest wartością domyślną, podczas tworzenia lub publikowania z dodatku w programie Visual Studio. Jeśli aplikacja pomyślnie ładuje dodatek, LoadBehavior wartość pozostaje 3.W przypadku wystąpienia błędu podczas ładowania dodatku, LoadBehavior wartość zmienia się na 2 i pozostaje na poziomie 2 po zamknięciu aplikacji.
8	Rozładowane	Ładuj na żądanie	Aplikacja nie próbuje załadować dodatek automatycznie.Użytkownika można spróbować ręcznie załadować dodatek lub dodatek może być załadowany programowo. Jeśli aplikacja pomyślnie ładuje dodatek, LoadBehavior wartość zmieni się na 9.
9	Załadowane	Ładuj na żądanie	Dodatek będzie ładowany tylko wtedy, gdy aplikacja wymaga, takich jak, gdy użytkownik kliknie element interfejsu użytkownika używający funkcji w dodatku (na przykład, niestandardowy przycisk na Wstążce). Jeśli aplikacja pomyślnie ładuje dodatek, LoadBehavior wartość pozostaje 9, ale stan dodatek w Dodatki COM okno dialogowe jest aktualizowany, aby wskazać, że dodatek jest aktualnie załadowany.W przypadku wystąpienia błędu podczas ładowania dodatku, LoadBehavior wartość zmieni się na 8.
16	Załadowane	Załadować po raz pierwszy, a następnie Ładuj na żądanie	Wartość tę należy wybrać, jeśli chcesz opracowywanego dodatku mają zostać załadowane na żądanie.Add-in do ładowania aplikacji, gdy użytkownik uruchomi aplikację po raz pierwszy.Następnym razem użytkownik uruchomi aplikację, wszystkie elementy interfejsu użytkownika, które są definiowane przez dodatek ładowania aplikacji, ale dodatek nie jest ładowany aż użytkownik kliknie element interfejsu użytkownika, który jest skojarzony z dodatku. Gdy aplikacja pomyślnie ładuje dodatek po raz pierwszy, LoadBehavior wartość pozostaje 16, podczas gdy dodatek jest załadowany.Po zamknięciu aplikacji, LoadBehavior wartość zmieni się na 9.