Belge Düzeyi Özelleştirmeleri Mimarisi
Visual Studio 2010, Microsoft Office Word ve Microsoft Office Excel belge düzeyi özelleştirmeleri oluşturmak için projeler içerir. Bu konuda belge düzeyi özelleştirmelerinin aşağıdaki açıları anlatır:
Özelleştirmeleri anlama
Özelleştirmelerin bileşenleri
Microsoft Office uygulamalarıyla özelleştirmeler nasıl çalışır
Uygulama alanı: Bu konudaki bilgiler şu uygulamaların belge düzeyi projelerine yöneliktir: Excel 2007 ve Excel 2010; Word 2007 ve Word 2010. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.
Belge düzeyi özelleştirmeleri oluşturma hakkında genel bilgi için bkz. Office Çözümleri Geliştirmesine Genel Bakış , Word İçin Belge Düzeyi Özelleştirmesi Programlamasına Başlarken ve Excel İçin Belge Düzeyi Özelleştirmeleri Programlamasına Başlarken.
Özelleştirmeleri Anlama
Belge düzeyi özelleştirmesi yapılandırmak için Visual Studio'daki Office geliştirme araçlarını kullandığınızda, belirli bir belgeyle ilişkilendirilen, yönetilen bir kod derlemesi oluşturursunuz. Bağlı derlemesi olan belge veya çalışma kitabı, yönetilen kod uzantılarına sahiptir. Daha fazla bilgi için bkz. Office Çözümleri Derlemelerine Genel Bakış.
Kullancı bir belge açtığında, Microsoft Office uygulaması tarafından derleme yüklenir. Derleme yüklendikten sonra, özelleştirme belge açık olduğunda olaylara yanıt verebilir. Özelleştirme, belge açık olduğunda 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 Derlemeler ve Office Çözümleri Geliştirmesine Genel Bakış.
Kullanıcı çoklu belge düzeyi özelleştirmelerini aynı anda açarsa, her derleme farklı uygulama etki alanında yüklenir. Bu, yanlış çalışan bir çözümün diğer çözümlerin başarısız olmasına sebep olamaz. Belge düzeyi özelleştirmeleri, tek uygulama etki alanındaki tek belgeyle çalışmak için tasarlanmıştır. Belge arası iletişim için tasarlanmamışlardır. Uygulama etki alanları hakkında daha fazla bilgi için, bkz. Application Domains.
Not
Visual Studio'da Office geliştirici aletleriyle oluşturduğunuz belge düzeyi özelleştirmeleri, sadece uygulama 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), özelleştirme beklendiği gibi çalışmayabilir.
Tasarım Zamanı ve Çalışma Zamanı Deneyimleri
Belge düzeyi özelleştirmelerinin mimarısini anlamak için, bir çözüm tasarlamanın ve çözümü çalıştırmanın deneyimlerini anlamak üzere yardım eder.
Tasarım Zamanı
Tasarım zamanı deneyimi aşağıdakileri içerir:
Geliştirici belge düzeyi projesini Visual Studio'da oluşturur. Proje, belgeyi ve belgenin arkasında çalışan derlemeyi içerir. Belge zaten varolabilir (belki tasarımcı tarafından oluşturulmuştur) veya yeni belge projeyle birlikte oluşturulabilir.
Tasarımcı (projeyi oluşturan geliştirici veya başka birisi) en sonki görünüm ve kullanımını son kullanıcı için oluşturur.
Çalışma Zamanı
Çalışma zamanı deneyimi aşağıdakileri içerir:
Son kullanıcı, yönetilen kod uzantıları olan belge veya çalışma kitabını açar.
Belge veya çalışma kitabı derlenmiş derlemeyi yükler.
Derleme, kullanıcı belgede veya çalışma kitabında çalışırken olaylara yanıt verir.
Karşılaştırılmış Geliştirici ve Son Kullanıcı Bakış Açısı
Geliştirici genellikle Visual Studio içinde çalıştığı için ve son kullanıcı Word ve Excel'de çalıştığı için, belge düzeyi özelleştirmelerini anlamanın iki yolu vardır.
Geliştiricinin Bakış Açısı |
Son Kullanıcının Bakış Açısı |
|---|---|
Visual Studio kullanarak, geliştirici Word veya Excel'de erişilebilir olan kod yazar. Geliştirici Word veya Excel'de çalışan çalıştırılabilir dosya oluşturuyor gibi görünse de, işlem aslında diğer yönden çalışır. Belge, derlemeyle ilişkilendirilir ve o derlemeye bir işaretçi içerir. Belge açıldığında, Word veya Excel derlemeyi bulur ve tüm işlenmiş olaylara yanıt olarak kodu çalıştırır. |
Çözümü kullananlar, belgeyi veya çalışma kitabını, diğer Microsoft Office dosyasını açar gibi açar (veya yeni belgeyi şablondan oluşturur). Derleme, belge veya çalışma kitabındaki özelleştirmeleri sağlar, örn. otomatik olarak geçerli veriyle doldurma veya istek bilgisine bir iletişim kutusu görüntüleme. |
Belge Düzeyi Özelleştirmeleri için Desteklenen Belge Biçimleri
Özelleştirme projesi oluşturduğunuzda, projede kullanmak istediğiniz belgenin biçimini seçebilirsiniz. Daha fazla bilgi için bkz. Nasıl Yapılır: Visual Studio'da Office Projeleri Oluşturma.
Aşağıdaki tabloda, Word veya Excel belge düzeyi özelleştirmelerinde kullanabileceğiniz belge biçimleri listelenir.
Excel |
Word |
|---|---|
Excel çalışma kitabı (.xlsx) Excel makro içerebilen çalışma kitabı (.xlsm) Excel ikili çalışma kitabı (.xlsb) Excel 97-2003 çalışma kitabı (.xls) Excel şablonu (.xltx) Excel makro içerebilen şablon (.xltm) Excel 97-2003 şablonu (.xlt) |
Word belgesi (.docx) Word makro içerebilen belge (.docm) Word 97-2003 belgesi (.doc) Word şablonu (.dotx) Word makro içerebilen şablon (.dotm) Word 97-2003 şablonu (.dot) |
Sadece desteklenen biçimlerdeki belgeler için yönetilen kod uzantıları tasarlamalısınız. Aksi durumda, belge uygulamada açık olduğunda bazı olaylar oluşmayabilir. Örneğin, yönetilen kod uzantılarını Excel XML elektronik tablo biçiminde veya Web sayfası (.htm; .html) biçiminde kaydedilmiş çalışma kitaplarıyla kullandığınızda, Open olayı oluşmaz.
.xml Dosya Adı Uzantısı Olan Word Belgeleri için Destek
Belge düzeyi proje şablonları, aşağıdaki dosya biçimlerine bağlı projeler oluşturmanıza izin vermez:
Word XML Belgesi (*xml).
Word 2003 XML Belgesi (*xml).
Son kullanıcılarınızın bu dosya biçimlerindeki özelleştirmeleri kullanmasını istiyorsanız, yukarıdaki tabloda belirtilen dosya biçimlerinden birini kullanan bir özelleştirmeyi yapılandırın ve dağıtın. Özelleştirmeyi yükledikten sonra, son kullanıcılar belgeyi Word XML Belgesi (*xml) biçiminde veya Word 2003 XML Belgesi (*xml) biçiminde kaydedebilir ve özelleştirme beklendiği gibi çalışmaya devam eder.
Özelleştirmelerin Bileşenleri
Bir özelleştirmenin ana bileşenleri belge ve derlemedir. Bu bileşenlere ek olarak, Microsoft Office uygulamalarının eklentileri nasıl buldukları ve yükledikleri hakkında önemli rol oynayan diğer birçok parça vardır.
Dağıtım Bildirimi ve Uygulama Bildirimi
Özelleştirme derlemesinin güncel sürümünü belirlemek ve yüklemek için, özelleştirmeler dağıtım bildirimlerini ve uygulama bildirimlerini kullanır. Dağıtım bildirimi, geçerli uygulama bildirimini gösterir. Uygulama bildirimi, özelleştirme derlemesini gösterir ve derlemede yürütmek için giriş noktası sınıfını (veya sınıfları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 içindeki Office geliştirme araçları kullanılarak oluşturulan belge düzeyi eklentilerini çalıştırmak için, son kullanıcı bilgisayarlarında Visual Studio Tools for Office çalışma zamanı modülü yüklü olmalıdır. Visual Studio Tools for Office çalışma zamanı modülü, özelleştirme derlemesini yükleyen yönetilmeyen bileşenleri ve ayrıca yönetilen derlemelerin bir kümesini içerir. Bu yönetilen derlemeler, özelleştirme 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 Özelleştirmeler Nasıl Çalışır
Kullanıcı, Microsoft Office özelleştirmesinin parçası olan bir belge açtığında, uygulama özelleştirme derlemesinin en güncel sürümünü bulmak ve yüklemek için belgeye bağlı olan dağıtım bildirimini kullanır. Dağıtım bildiriminin konumu, _AssemblyLocation isimli özel belge özelliğinde saklanır. Bu konumu belirleyen dize, çözümü yapılandırdığınızda özelliğe eklenir.
Dağıtım bildirimi, en güncel derlemeyi işaret eden uygulama bildirimini işaret eder. Daha fazla bilgi için bkz. Office Çözümlerinde Uygulama ve Dağıtım Bildirimleri.
Aşağıdaki gösterim, belge düzeyi özelleştirmesinin temel mimarisini gösterir.
Özelleştirme mimarisi
.png "2007 Office özelleştirme mimarisi")
Not
.NET Framework 4 hedefleyen Office çözümlerinde, çözümler PIA'i doğrudan çağırmak yerine çözüm derlemesine gömülü olan PIA tür bilgisini kullanarak, konak uygulamasının nesne modelini çağırabilir. Daha fazla bilgi için bkz. Office Çözümleri Tasarlama ve Oluşturma.
Yükleme İşlemi
Aşağıdaki adımlar, kullanıcı Microsoft Office çözümünün parçası olan bir belge açtığında meydana gelir:
Microsoft Office uygulaması, belgeyle ilişkili yönetilen kod uzantılarının olup olmadığına bakmak için özel belge özelliklerini denetler. Daha fazla bilgi için bkz. Özel Belge Özelliklerine Genel Bakış.
Eğer yönetilen kod uzantıları varsa, uygulama VSTOLoader.dll yükleyen VSTOEE.dll yükler. Bunlar, Visual Studio 2010 Tools for Office Çalışma Zamanı Modülü için yükleyici bileşenleri olan yönetilmeyen DLL'lerdir. 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 Visual Studio Tools for Office çalışma zamanı modülü'ın yönetilen kısmına başlar.
Eğer belge yerel bilgisayar dışında başka bir bilgisayardan açılırsa, Visual Studio Tools for Office çalışma zamanı modülü belgenin konumunun, o Office uygulaması için Güven Merkezi Ayarları'ndaki Güvenilir Konumlar listesinde olduğunu doğrular. Eğer belge konumu güvenilir konumda değilse, özelleştrmeye güvenilmez ve tükleme işlemi orada durur.
Visual Studio Tools for Office çalışma zamanı modülü, eğer çözüm yüklenmemişse onu yükler, en güncel uygulamayı ve dağıtım bildirimilerini yükler ve bir dizi güvenlik denetimi gerçekleştirir. Daha fazla bilgi için bkz. Office Çözümlerinin Güvenliğini Sağlama.
Eğer özelleştirme, çalıştırmak için güvenilirse, Visual Studio Tools for Office ç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 yükler. Daha fazla bilgi için bkz. Office Çözümlerini Dağıtma.
Visual Studio Tools for Office çalışma zamanı modülü, özelleştirme derlemesinin yükleneceği yeni bir uygulama etki alanı oluşturur.
Visual Studio Tools for Office çalışma zamanı modülü, özelleştirme derlemesini uygulama etki alanına yükler.
Visual Studio Tools for Office çalışma zamanı modülü, özelleştirme derlemenizde Startup olay işleyicisini çağırır. Daha fazla bilgi için bkz. Office Projelerindeki Olaylar.
Ayrıca bkz.
Kavramlar
Uygulama Düzeyi Eklentisi Mimarisi
Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış
Özel Belge Özelliklerine Genel Bakış
Belge Düzeyi Özelleştirmelerinde Önbellekteki Veri
Diğer Kaynaklar
Visual Studio'da Office Çözümleri Mimarisi