Belge Düzeyi Özelleştirmeleri Mimarisi

Visual Studio 2012, 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 2013 ve Excel 2010; Word 2013 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 Tasarlama ve Oluşturma.

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ışılabilirlik montajları 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. Uygulama etki alanları.

[!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, 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:

1. 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.

2. Tasarımcı — proje veya bir başkası oluşturur ya da Geliştirici — son görünüm belgenin son kullanıcı için oluşturur.

Çalışma Zamanı

Çalışma zamanı deneyimi aşağıdakileri içerir:

1. Son kullanıcı, yönetilen kod uzantıları olan belge veya çalışma kitabını açar.

2. Belge veya çalışma kitabı derlenmiş derlemeyi yükler.

3. 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 Office projeler oluşturmak.

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, Open olayı oluşmaz yönetilen kod uzantılarını Excel xml elektronik tablo biçiminde veya web sayfası (.htm; kaydedilmiş çalışma kitaplarıyla kullandığınızda, .HTML) biçiminde.

.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 Office için Visual Studio Araçları çalışma zamanı modülü yüklü olmalıdır.Office için Visual Studio Araçları ç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

[!NOT]

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

Yükleme İşlemi

Microsoft Office çözümünün bir parçası olan bir belgeyi açtığında, aşağıdaki adımlar gerçekleşir.

1. 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ış.

2. Eğer yönetilen kod uzantıları varsa, uygulama VSTOLoader.dll yükleyen VSTOEE.dll 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ış.

3. 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.

4. Eğer belge yerel bilgisayar dışında başka bir bilgisayardan açılırsa, Office için Visual Studio Araçları ç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.

5. Office için Visual Studio Araçları çalışma zamanı modülü, eğer çözüm yüklenmemişse onu yükler, en güncel uygulamayı ve dağıtım bildirimilerini indirir ve bir dizi güvenlik denetimi gerçekleştirir.Daha fazla bilgi için bkz. Office Çözümlerinin Güvenliğini Sağlama.

6. Eğer özelleştirme, ç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.

7. Office için Visual Studio Araçları çalışma zamanı modülü, özelleştirme derlemesinin yükleneceği yeni bir uygulama etki alanı oluşturur.

8. Office için Visual Studio Araçları çalışma zamanı modülü, özelleştirme derlemesini uygulama etki alanına yükler.

9. Office için Visual Studio Araçları çalışma zamanı modülü, özelleştirme derlemenizde Startup olay işleyicisini çağırır.Daha fazla bilgi için, 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

Office Çözümlerinin Güvenliğini Sağlama

Office Çözümleri Tasarlama ve Oluşturma