Uygulama Düzeyi Eklentisi Mimarisi

Makale
02/26/2013

Visual Studio'daki Office geliştirme araçları kullanılarak oluşturulan eklentiler, kararlılık ve güvenlik sağlayan mimari özelliklere sahiptir ve onların Microsoft Office'le yakından çalışmasına olanak sağlar.Bu konuda eklentilerin aşağıdaki açıları anlatır:

Eklentileri anlama
Eklentilerin bileşenleri
Microsoft Office uygulamalarıyla eklentilerin nasıl çalıştığı

Uygulama alanı: Bu konudaki bilgiler Microsoft Office 2013 ve Microsoft Office 2010'un uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Eklentiler oluşturma hakkında daha fazla bilgi için, bkz. Office Çözümleri Geliştirmesine Genel Bakış ve Uygulamaya Düzeyi Eklentilerini Programlamaya Başlarken.

Eklentileri Anlama

Eklenti yapılandırmak için Visual Studio'daki Office geliştirme araçlarını kullandığınızda, Microsoft Office uygulaması tarafından yüklenen bir yönetilen kod derlemesi oluşturursunuz.Derleme yüklendiğinde, eklenti uygulamada başlatılan olaylara (örn. kullanıcı bir menü öğesine tıkladığında) cevap verebilir.Eklenti ayrıca nesne modelini çağırıp uygulamayı genişletebilir ve .NET Framework'deki herhangi bir sınıfı kullanabilir.

Derleme, uygulamanın COM bileşenleriyle, uygulamanın birincil birlikte çalışma derlemesi tarafından iletişim kurar.Daha fazla bilgi için, bkz. Office birincil birlikte çalışılabilirlik montajları ve Office Çözümleri Geliştirmesine Genel Bakış.

Eğer bir uygulama için çoklu eklentiler yüklenirse, her eklenti farklı bir uygulama etki alanına yüklenir.Bu, yanlış çalışan bir eklentinin diğer eklentilerin başarısız olmasına sebep olamaz.Ayrıca, uygulama kapatıldığında, tüm eklenti derlemelerinin bellekten yüklenmemesini sağlamaya yardımcı olur. Uygulama etki alanları hakkında daha fazla bilgi için, bkz. Uygulama etki alanları.

[!NOT]

Visual Studio'da Office geliştirici aletleriyle oluşturduğunuz eklentiler, sadece konak Microsoft Office uygulaması bir son kullanıcı tarafından başlatıldığında kullanılmak için tasarlanmıştır.Eğer uygulama programlı olarak başlarsa (örn, Otomasyon kullanarak), eklenti beklendiği gibi çalışmayabilir.

Eklentilerin Bileşenleri

Eklenti derlemesi ana bileşen olsa bile, Microsoft Office uygulamalarının eklentileri nasıl buldukları ve yükledikleri hakkında önemli rol oynayan diğer birçok bileşen vardır.

Kayıt Defteri Girdileri

Microsoft Office uygulamaları, bir küme kayıt defteri girdisine bakarak eklentileri bulur.Eklentiler tarafından kullanılan kayıt defteri girdilerinin tüm listesi için, bkz. Uygulama Düzeyi Eklentileri için Kayıt Defteri Girdileri.

Çözümünüzü yapılandırdığınızda, eklentinizi çalıştırmanız ve hatasını ayıklamanız için Visual Studio tüm gerekli kayıt defteri girdilerini geliştirme bilgisayarında oluşturur.Daha fazla bilgi için bkz. Office çözümler oluşturma.

Çözümünüzü dağıtmak için ClickOnce kullanırsanız, yayımlama işlemi tarafından yaratılan Kurulum programı otomatik olarak kayıt defteri anahtarlarını son kullanıcı bilgisayarında oluşturur. Daha fazla bilgi için bkz. ClickOnce Kullanarak Office Çözümü Dağıtma.

Dağıtım Bildirimi ve Uygulama Bildirimi

Eklenti derlemesinin güncel sürümünü belirlemek ve yüklemek için, eklentiler dağıtım bildirimlerini ve uygulama bildirimlerini kullanır.Dağıtım bildirimi, geçerli uygulama bildirimini gösterir.Uygulama bildirimi, eklenti derlemesini gösterir ve derlemede yürütmek için giriş noktası sınıfını belirler.Daha fazla bilgi için bkz. Office Çözümlerinde Uygulama ve Dağıtım Bildirimleri.

Office Runtime için Visual Studio

Visual Studio'da Office geliştirme araçları kullanılarak oluşturulan eklentileri çalıştırmak için son kullanıcı bilgisayarlarında yüklü olmalıdır Office için Visual Studio Araçları çalışma zamanı modülü yüklü. Çalışma zamanı, yönetilmeyen bileşenleri ve yönetilen derlemelerin bir kümesini içerir.Yönetilmeyen bileşenler eklenti derlemesini yükler.Yönetilen derlemeler, eklenti kodunuzun konak uygulamasını otomatikleştirmek ve genişletmek için kullandığı nesne modelini sağlar.

Daha fazla bilgi için bkz. Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.

Microsoft Office Uygulamalarıyla Eklentiler Nasıl Çalışır

Kullanıcı Microsoft Office uygulamasını başlattığında uygulama, en geçerli eklenti derlemesi sürümünü bulmak ve yüklemek için dağtım bildirimini ve uygulama bildirimini kullanır. Aşağıdaki çizim, bu eklentilerin temel mimarisini gösterir.

Eklenti mimarisi

2007 Office eklenti mimarisi

[!NOT]

' İ hedefleyen Office çözümlerinde .NET Framework 4 veya .NET Framework 4.5, tarafından konak uygulamasının nesne modeline çağrı PIA'i doğrudan çağırmak yerine çözüm derlemesine gömülü olan PIA tür bilgisini kullanarak çözümler.Daha fazla bilgi için bkz. Office Çözümleri Tasarlama ve Oluşturma.

Yükleme İşlemi

Kullanıcı bir uygulamayı başlattığında aşağıdaki adımlar gerçekleşir:

Uygulama, Visual Studio'daki Office geliştirici aletler kullanılarak oluşturulan eklentileri belirleyen kayıt defteri girdilerini denetler.
Eğer uygulama bu kayıt defteri girdilerini bulursa, uygulama VSTOLoader.dll yükleyen VSTOEE.dll'i yükler.Bu yönetilmeyen DLL Office Runtime için Visual Studio 2010 Araçları için yükleyici bileşenleri olan.Daha fazla bilgi için bkz. Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.
VSTOLoader.dll, .NET Framework yükler ve Office için Visual Studio Araçları çalışma zamanı modülü'ın yönetilen kısmına başlar.
Office için Visual Studio Araçları çalışma zamanı modülü, bildirim güncellemelerini denetler ve en son uygulamayı ve dağıtım bildirimlerini indirir.
Office için Visual Studio Araçları çalışma zamanı modülü, bir dizi güvenlik denetimi gerçekleştirir.Daha fazla bilgi için bkz. Office Çözümlerinin Güvenliğini Sağlama.
Eğer uygulama, çalıştırmak için güvenilirse, Office için Visual Studio Araçları çalışma zamanı modülü derleme güncellemelerini denetlemek için dağıtım bildirmini ve uygulama bildirimini kullanır.Eğer derlemenin yeni bir sürümü kullanılabilirse, çalışma zamanı, derlemenin yen sürümünü istemci bilgisayarındaki ClickOnce önbelleğine indirir.Daha fazla bilgi için bkz. Office Çözümünü Dağıtma.
Office için Visual Studio Araçları çalışma zamanı modülü, eklenti derlemesinin yükleneceği yeni bir uygulama etki alanı oluşturur.
Office için Visual Studio Araçları çalışma zamanı modülü, eklenti derlemesini uygulama etki alanına yükler.
Office için Visual Studio Araçları çalışma zamanı modülü, eğer siz onu geçersiz kıldıysanız, eklentinizdeki RequestComAddInAutomationService yöntemini çağırır.

Eklentinizdeki bir nesneyi başka Microsoft Office çözümlerine geçirmek için bu yöntemi isteğe bağlı bir şekilde geçersiz kılabilirsiniz.Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentilerindeki Kodu Başka Office Çözümlerinden Çağırma.
Office için Visual Studio Araçları çalışma zamanı modülü, eğer siz onu geçersiz kıldıysanız, eklentinizdeki RequestService yöntemini çağırır.

Genişletilebilirlik arayüzünü uygulayan bir nesneyi döndürerek Microsoft Office özelliğini genişletmek için, bu yöntemi isteğe bağlı bir şekilde geçersiz kılabilirsiniz.Daha fazla bilgi için bkz. Genişletilebilirlik Arabirimi Kullanarak Kullanıcı Arabirimi (KA) Özelliklerini Özelleştirme.

[!NOT]

Office için Visual Studio Araçları çalışma zamanı modülü, uygulama tarafından desteklenen her genişletilebilirlik arayüzü için RequestService yöntemine ayrı çağrılar yapar.RequestService yöntemine yapılan ilk çağrı, genellikle ThisAddIn_Startup yöntemine yapılan çağrıdan önce olmasına rağmen, eklentiniz RequestService yönteminin ne zaman veya kaç kere çağrılacağına dair varsayımlar yapmamalıdır.
Office için Visual Studio Araçları çalışma zamanı modülü, eklentinizdeki ThisAddIn_Startup'ı çağırır.Bu yöntem, Startup olayı için varsayılan olay işleyicisidir.Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.