IManagedAddin — interfejs

  • Artykuł

Zaimplementuj interfejs IManagedAddin, aby utworzyć składnik, który ładuje zarządzane dodatki VSTO. Ten interfejs został dodany w systemie Microsoft Office 2007.

Składnia

[
    object,
    uuid(B9CEAB65-331C-4713-8410-DDDAF8EC191A),
    pointer_default(unique),
    oleautomation
]
interface IManagedAddin : IUnknown
{
    HRESULT Load(
        [in] BSTR bstrManifestURL,
        [in] IDispatch *pdispApplication);
    HRESULT Unload();
};

Metody

W poniższej tabeli wymieniono metody zdefiniowane przez interfejs IManagedAddin.

Nazwa/nazwisko opis
IManagedAddin::Load Wywoływana, gdy aplikacja pakietu Office lication firmy Microsoft ładuje zarządzany dodatek VSTO.
IManagedAddin::Unload Wywoływana tuż przed aplikacja pakietu Office licacją firmy Microsoft zwalnia zarządzany dodatek VSTO.

Uwagi

Microsoft aplikacja pakietu Office lications, począwszy od systemu Microsoft Office 2007, użyj interfejsu IManagedAddin, aby ułatwić ładowanie dodatków pakietu Office VSTO. Interfejs IManagedAddin można zaimplementować, aby utworzyć własny dodatek VSTO i środowisko uruchomieniowe dla zarządzanych dodatków VSTO, zamiast używać modułu ładującego dodatku VSTO (VSTOLoader.dll) i środowiska uruchomieniowego Visual Studio Tools dla pakietu Office . Aby uzyskać więcej informacji, zobacz Architektura dodatków VSTO.

Jak ładowane są zarządzane dodatki

Podczas uruchamiania aplikacji są wykonywane następujące kroki:

  1. Aplikacja odnajduje dodatki VSTO, wyszukując wpisy w następującym kluczu rejestru:

    HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\

    Każdy wpis w tym kluczu rejestru jest unikatowym identyfikatorem dodatku VSTO. Zazwyczaj jest to nazwa zestawu dodatku VSTO.

  2. Aplikacja szuka wpisu pod wpisem Manifest dla każdego dodatku VSTO.

    Zarządzane dodatki VSTO mogą przechowywać pełną ścieżkę manifestu we wpisie w obszarze HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\<add-in ID>.Manifest Manifest to plik (zazwyczaj plik XML), który zawiera informacje używane do ładowania dodatku VSTO.

  3. Jeśli aplikacja znajdzie wpis, aplikacja podejmie próbę Manifest załadowania zarządzanego składnika modułu ładującego dodatku VSTO. Aplikacja robi to, próbując utworzyć obiekt COM, który implementuje interfejs IManagedAddin.

    Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office zawiera składnik modułu ładującego dodatku VSTO (VSTOLoader.dll) lub możesz utworzyć własny, implementując interfejs IManagedAddin.

  4. Aplikacja wywołuje metodę IManagedAddin::Load i przekazuje wartość Manifest wpisu.

  5. Metoda IManagedAddin::Load wykonuje zadania wymagane do załadowania dodatku VSTO, takie jak konfigurowanie domeny aplikacji i zasad zabezpieczeń dla ładowanego dodatku VSTO.

    Aby uzyskać więcej informacji na temat kluczy rejestru używanych przez firmę Microsoft aplikacja pakietu Office lications do odnajdywania i ładowania zarządzanych dodatków VSTO, zobacz Wpisy rejestru dla dodatków VSTO.

Wskazówki dotyczące implementowania funkcji IManagedAddin

W przypadku zaimplementowania biblioteki IManagedAddin należy zarejestrować bibliotekę DLL zawierającą implementację przy użyciu następującego identyfikatora CLSID:

99D651D7-5F7C-470E-8A3B-774D5D9536AC

Microsoft aplikacja pakietu Office lications używają tego identyfikatora CLSID do utworzenia obiektu COM, który implementuje element IManagedAddin.

Uwaga

Ten identyfikator CLSID jest również używany przez bibliotekę VSTOLoader.dll w środowisku uruchomieniowym Visual Studio Tools dla pakietu Office . W związku z tym, jeśli używasz narzędzia IManagedAddin do tworzenia własnego składnika ładującego dodatku VSTO i składnika środowiska uruchomieniowego, nie można wdrożyć składnika na komputerach z uruchomionymi dodatkami VSTO, które opierają się na środowisku uruchomieniowym Visual Studio Tools dla pakietu Office .

Zobacz też