IManagedAddin arabirimi

  • Makale

Yönetilen VSTO Eklentilerini yükleyen bir bileşen oluşturmak için IManagedAddin arabirimini uygulayın. Bu arabirim 2007 Microsoft Office sistemine eklendi.

Sözdizimi

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

Yöntemler

Aşağıdaki tabloda IManagedAddin arabirimi tarafından tanımlanan yöntemler listelenir.

Veri Akışı Adı Açıklama
IManagedAddin::Load Bir Microsoft Office uygulaması lication yönetilen bir VSTO Eklentisi yüklediğinde çağrılır.
IManagedAddin::Unload Microsoft Office uygulaması'nin yönetilen bir VSTO Eklentisini kaldırmadan hemen önce çağrılır.

Açıklamalar

Microsoft Office uygulaması lications, 2007 Microsoft Office sisteminden başlayarak, Office VSTO Eklentilerini yüklemeye yardımcı olmak için IManagedAddin arabirimini kullanır. Yönetilen VSTO Eklentileri için VSTO Eklenti yükleyicisini (VSTOLoader.dll) ve Office çalışma zamanı için Visual Studio Araçları kullanmak yerine kendi VSTO Eklenti yükleyicinizi ve çalışma zamanınızı oluşturmak için IManagedAddin arabirimini uygulayabilirsiniz. Daha fazla bilgi için bkz . VSTO Eklentilerinin Mimarisi.

Yönetilen Eklentiler nasıl yüklenir?

Bir uygulama başlatıldığında aşağıdaki adımlar gerçekleşir:

  1. Uygulama, aşağıdaki kayıt defteri anahtarı altındaki girdileri arayarak VSTO Eklentilerini bulur:

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

    Bu kayıt defteri anahtarının altındaki her girdi, VSTO Eklentisinin benzersiz bir kimliğidir. Bu genellikle VSTO Eklenti derlemesinin adıdır.

  2. Uygulama, her VSTO Eklentisi için girdinin altında bir Manifest girdi arar.

    Yönetilen VSTO Eklentileri, bir bildirimin Manifest tam yolunu HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\<add-in id> altındaki girdide depolayabilir. Bildirim, VSTO Eklentisi'ni yüklemeye yardımcı olmak için kullanılan bilgileri sağlayan bir dosyadır (genellikle XML dosyasıdır).

  3. Uygulama bir Manifest girdi bulursa, uygulama yönetilen bir VSTO Eklenti yükleyici bileşenini yüklemeye çalışır. Uygulama bunu IManagedAddin arabirimini uygulayan bir COM nesnesi oluşturmaya çalışarak yapar.

    Office çalışma zamanı için Visual Studio Araçları bir VSTO Eklenti yükleyici bileşeni (VSTOLoader.dll) içerir veya IManagedAddin arabirimini uygulayarak kendi eklentinizi oluşturabilirsiniz.

  4. Uygulama IManagedAddin::Load yöntemini çağırır ve girdinin Manifest değerini geçirir.

  5. IManagedAddin::Load yöntemi, yüklenen VSTO Eklentisi için uygulama etki alanını ve güvenlik ilkesini yapılandırma gibi VSTO Eklentisini yüklemek için gereken görevleri gerçekleştirir.

    Microsoft Office uygulaması lications'ın yönetilen VSTO Eklentilerini bulmak ve yüklemek için kullandığı kayıt defteri anahtarları hakkında daha fazla bilgi için bkz. VSTO Eklentileri için kayıt defteri girdileri.

IManagedAddin uygulama kılavuzu

IManagedAddin uygularsanız, aşağıdaki CLSID'yi kullanarak uygulamayı içeren DLL'yi kaydetmeniz gerekir:

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

Microsoft Office uygulaması lications, IManagedAddin uygulayan COM nesnesini oluşturmak için bu CLSID'yi kullanır.

Dikkat

Bu CLSID, Office çalışma zamanı için Visual Studio Araçları VSTOLoader.dll tarafından da kullanılır. Bu nedenle, kendi VSTO Eklenti yükleyicinizi ve çalışma zamanı bileşeninizi oluşturmak için IManagedAddin kullanırsanız, bileşeninizi Office çalışma zamanı için Visual Studio Araçları kullanan VSTO Eklentileri çalıştıran bilgisayarlara dağıtamazsınız.

Ayrıca bkz.