Uygulama Düzeyi Eklentileri Mimarisi

Makale
06/10/2015

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 hedefi: Bu konudaki bilgiler, Microsoft Office 2013 ve Microsoft Office 2010 için uygulama düzeyi projelere yöneliktir. Daha fazla bilgi edinmek için, bkz. Office Uygulaması ve Proje Türüne Göre Kullanılabilir Özellikler.

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

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ışma Derlemeleri 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 İç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ümleri 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 çalışma zamanı için Visual Studio Araçları 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 Çalışma Zamanı İçin Visual Studio Araçları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 Çalışma Zamanı İçin Visual Studio Araçlarına Genel Bakış.
VSTOLoader.dll, .NET Framework yükler ve Office çalışma zamanı için Visual Studio Araçları'ın yönetilen kısmına başlar.
Office çalışma zamanı için Visual Studio Araçları, bildirim güncellemelerini denetler ve en son uygulamayı ve dağıtım bildirimlerini indirir.
Office çalışma zamanı için Visual Studio Araçları, bir dizi güvenlik denetimi gerçekleştirir.Daha fazla bilgi için bkz. Office Çözümleri Güvenliğini Sağlama.
Eğer uygulama, çalıştırmak için güvenilirse, Office çalışma zamanı için Visual Studio Araçları 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 çalışma zamanı için Visual Studio Araçları, eklenti derlemesinin yükleneceği yeni bir uygulama etki alanı oluşturur.
Office çalışma zamanı için Visual Studio Araçları, eklenti derlemesini uygulama etki alanına yükler.
Office çalışma zamanı için Visual Studio Araçları, 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 Eklentilerinde Diğer Office Çözümlerinden Kod Çağırma.
Office çalışma zamanı için Visual Studio Araçları, 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 Arabirimlerini Kullanarak Kullanıcı Arabirimi Özelliklerini Özelleştirme.

[!NOT]

Office çalışma zamanı için Visual Studio Araçları, 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 çalışma zamanı için Visual Studio Araçları, 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.