Uygulama Düzeyi Eklentileri için Kayıt Defteri Girdileri
Visual Studio 2010 kullanılarak oluşturulmuş eklentileri dağıttığınızda belirli bir kayıt defteri kümesi yaratmalısınız. Bu kayıt defteri girdileri Microsoft Office uygulamasının eklentiyi bulup yüklemesini etkinleştirecek bilgileri sağlar.
Uygulama alanı: Bu konudaki bilgiler, Microsoft Office 2010 ve 2007 Microsoft Office sisteminin uygulama düzeyi projelerine yöneliktir. Daha fazla bilgi için bkz: Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.
Projenizi yapılandırdığınızda eklentinizi çalıştırmanız ve hatasını ayıklamanız için Visual Studio bu kayıt defteri girdilerini geliştirme bilgisayarında oluşturur. Eklentiniz dağıtmak için ClickOnce kullanırsanız, son kullanıcının bilgisayarda kayıt defteri girdilerini otomatik olarak oluşturulur. Eklentiniz dağıtmak için Windows Installer'ı kullanırsanız, son kullanıcının bilgisayarda kayıt defteri girdileri oluşturmak için kurulum projesinin yapılandırmanız gerekir.
Kayıt defteri girdileri için Eklentiler yükleme işlemi sırasında nasıl kullanıldığı hakkında daha fazla bilgi için bkz: Uygulama Düzeyi Eklentisi Mimarisi.
Not
Bu konu içerisinde, add-in iD eklentiniz için eşsiz bir ID (kimlik)'yi temsil eder. Varsayılan olarak, kendi eklenti derlemesinin adı kimliğidir.
Eklentiler için geçerli kullanıcı vs kaydediliyor.Tüm Kullanıcılar
Bir eklentinin yüklendiğinde, iki yolla kaydedilebilir:
Yalnızca geçerli kullanıcı için (diğer bir deyişle, yalnızca eklentiyi yüklediğinizde, bilgisayara oturum açmış kullanıcı için kullanılabilir). Bu durumda, kayıt defteri girdilerini hkey_current_user altında oluşturulur.
Tüm kullanıcılar için (yani, bilgisayarda oturum eklentileri kullanabilirsiniz herhangi kullanıcı). Bu durumda, kayıt defteri girdilerini HKEY_LOCAL_MACHINE altında oluşturulur.
Tüm kullanarak oluşturduğunuz eklentileri Visual Studio 2010 kayıtlı için geçerli bir kullanıcı. Ancak, eklentiler, belirli senaryolarda yalnızca tüm kullanıcılar için kaydedilebilir. Bu senaryolar Microsoft Office sürümü bilgisayarda ve eklentinin nasıl dağıtıldığı bağlıdır.
Microsoft Office sürümü
Microsoft Office 2010 uygulamaları HKEY_LOCAL_MACHINE veya hkey_current_user altında kayıtlı eklentiler yükleyebilirsiniz.
Varsayılan olarak, 2007 Microsoft Office sistemi uygulamalarında yalnızca hkey_current_user altında kayıtlı eklentiler yükleyebilirsiniz. HKEY_LOCAL_MACHINE altında kayıtlı olan eklentileri yüklemek için bu uygulamalar yüklü olduğunda bilgisayarlara düzeltme paketi yüklü 976477 de olmalıdır. Daha fazla bilgi için bkz: https://go.microsoft.com/fwlink/?LinkId=184923.
Dağıtım türü
Bir eklenti dağıtmak için ClickOnce kullanırsanız, eklenti yalnızca geçerli kullanıcı için kaydedilebilir. ClickOnce oluşturma anahtarları hkey_current_user altında yalnızca destekler olmasıdır. Bir eklenti, bir bilgisayardaki tüm kullanıcılar için kaydetmek isterseniz, eklenti dağıtmak için Windows Installer'ı kullanmalısınız. Bu dağıtım türleri hakkında daha fazla bilgi için bkz: Office Çözümleri Yayımlama ve Office Çözümünü Windows Installer Kullanarak Dağıtma.
Kayıt Defteri Girdileri
Eklenti gerekli kayıt defteri girdileri, Visio dışında tüm uygulamalar için aşağıdaki kayıt defteri anahtarı altında bulunur burada kök hkey_current_user veya HKEY_LOCAL_MACHINE.
Kök\Software\Microsoft\Office\Uygulama adı\Addins\eklenti kimliği
Visio için kayıt defteri girdileri aşağıdaki kayıt defteri anahtarında ait.
Kök\Software\Microsoft\Visio\Addins\eklenti kimliği
Aşağıdaki tabloda, bu kayıt defteri anahtarı altındaki girdileri listeler.
Giriş |
Type |
Value |
|---|---|---|
Description |
REG_SZ |
Gerekli. Eklentinin kısa açıklaması. Microsoft Office uygulamasında, kullanıcı Seçenekler iletişim kutusunun Eklentiler bölmesinden eklentiyi seçtiğinde açıklama görüntülenir. |
FriendlyName |
REG_SZ |
Gerekli. Eklentinin açıklayıcı bir adı Microsoft Office uygulamasının COM Eklentileri iletişim kutusunda görüntülenir. Varsayılan değer eklentinin ID'sidir. |
LoadBehavior |
REG_DWORD |
Gerekli. Uygulamanın eklentiyi ve eklentinin geçerli durumunu ne zaman yüklemeye çalıştığını belirleyen bir değer. Varsayılan olarak bu girdi 3'tür ve eklentinin başlangıçta yüklenmesini söyler. Daha fazla bilgi için, bkz. LoadBehavior Değerleri. |
Manifest |
REG_SZ |
Gerekli. Eklentinin dağıtım bildiriminin tam yolu. Bu yol, yerel bilgisayardaki bir konum, bir ağ paylaşımı (UNC) veya bir Web Sunucusu olabilir (HTTP). Çözümü dağıtmak için Windows Installer'ı kullanırsanız, dize append |vstolocal (yani, dikey çizgi karakteri |ardından vstolocal) bu yolun sonuna. Bu çözüm ClickOnce önbellek yerine yükleme klasörüne yüklenir sağlar. Daha fazla bilgi için bkz. Office Çözümünü Windows Installer Kullanarak Dağıtma. .gif "Not") Not
Visual Studio geliştirme bilgisayarına bir eklenti oluştururken otomatik olarak ekler |vstolocal bu kayıt defteri girdisi dize.
|
Warmup |
REG_DWORD |
İsteğe Bağlı. Belirten bir değer.net Framework ve Visual Studio Tools for Office çalışma zamanı modülü önce bir eklentiyi yükler ve azaltmak algılanan zaman Ekle bileşenini yüklemek için Yükle Set Warmup 1 girişi ve bu birlikte kullanın LoadBehavior için Windows Installer (.msi) kullanılarak dağıtılan Outlook 2010 eklentileri yükleme süresini azaltmak için giriş. Bu kayıt defteri anahtarı ClickOnce kullanılarak ayarlanamaz. |
Outlook Form Bölgeleri için Kayıt Defteri Girdileri
Özel form bölge bir eklentinin Outlook için oluşturursanız, ek kayıt defteri girdilerini Outlook ile form bölge kaydetmek için kullanılır. Bu girdiler her form bölgesinin desteklediği her message (ileti) sınıfı için farklı bir kayıt defteri anahtarı altına oluşturulur. Bu kayıt defteri anahtarları aşağıdaki konumda olan yere kök hkey_current_user veya HKEY_LOCAL_MACHINE.
Kök\Software\Microsoft\Office\Outlook\FormRegions\ileti sınıfı
Tüm eklentilerin paylaştığı diğer kayıt defteri girdilerinde de olduğu gibi, Visual Studio geliştirme bilgisayarında form bölgesi kayıt defteri girdilerini projenizi derlediğiniz zaman oluşturur. Eklentiniz dağıtmak için ClickOnce kullanırsanız, son kullanıcının bilgisayarda kayıt defteri girdilerini otomatik olarak oluşturulur. Eklentiniz dağıtmak için Windows Installer'ı kullanırsanız, son kullanıcının bilgisayarda kayıt defteri girdileri oluşturmak için kurulum projesinin yapılandırmanız gerekir.
Form bölgesi kayıt defteri girdileri hakkında daha fazla bilgi için bkz. Specifying Form Regions in the Windows Registry. Outlook form bölgeleri hakkında daha fazla bilgi için, bkz. Outlook Form Bölgeleri Yaratma.
LoadBehavior Değerleri
LoadBehavior Altına kök\Software\Microsoft\Office\Uygulama adı\Addins\eklenti kodu anahtar eklenti çalıştırma davranışını belirleyen değerler bitwise birleşimini içerir. En düşük sıradaki bit (0 ve 1 değerleri) eklentinin şu anda yüklü veya yüklenmemiş olduğunu belirtir. Diğer bitler uygulamanın eklentiyi ne zaman yüklemeye çalışacağını belirtir.
Genellikle, LoadBehavior girdisi, 0, 3 veya 16 (de ondalık) ayarlamak için hazırlanmıştır, eklentinin yüklü son kullanıcı bilgisayar. Varsayılan olarak Visual Studio eklentinizin LoadBehavior girdisini eklentinizi derlediğinizde veya yayımladığınızda 3 olarak ayarlar.
Aşağıdaki tablo LoadBehavior girdisinin olası tüm değerlerini listeler. Bu tablodaki bazı açıklamalar bir eklentiyi el ile veya program aracılığıyla yüklemeye değinir. Bir eklentiyi el ile yüklemek için uygulamada COM Eklentileri iletişim kutusunun yanındaki onay kutusunu işaretleyin. Bir eklentiyi program aracılığıyla yüklemek için eklentiyi temsil eden COMAddIn nesnesinin Connect özelliğine true değerini verin.
Değer (ondalık olarak) |
Eklenti durumu |
Eklenti yükleme davranışı |
Açyklama |
|---|---|---|---|
0 |
Unloaded |
Otomatik olarak yüklenmez |
Uygulama hiçbir zaman eklentiyi otomatik olarak yüklemeye çalışmaz. Kullanıcı eklentiyi el ile yüklemeyi deneyebilir veya eklenti program aracılığıyla yüklenebilir. Eklenti başarılı bir biçimde yüklenirse LoadBehavior değeri 0 olarak kalır; fakat, COM Eklentileri iletişim kutusunda eklentinin durumu eklentinin yüklü olduğunu belirtecek şekilde güncellenir. |
1 |
Loaded |
Otomatik olarak yüklenmez |
Uygulama hiçbir zaman eklentiyi otomatik olarak yüklemeye çalışmaz. Kullanıcı eklentiyi el ile yüklemeyi deneyebilir veya eklenti program aracılığıyla yüklenebilir. Her ne kadar COM Eklentileri iletişim kutusu uygulama başladıktan sonra eklentinin yüklendiğini belirtse de eklenti el ile veya program aracılığıyla yüklenmeden gerçekten yüklenmiş olmaz. Uygulama başarılı bir şekilde eklentiyi yüklerse LoadBehavior değeri 0'a çevrilir ve uygulama kapandıktan sonra 0 olarak kalır. |
2 |
Unloaded |
Başlangıçta yüklenir |
Uygulama eklentiyi otomatik olarak yüklemeye çalışmaz. Kullanıcı eklentiyi el ile yüklemeyi deneyebilir veya eklenti program aracılığıyla yüklenebilir. Uygulama başarılı bir şekilde eklentiyi yüklerse LoadBehavior değeri 3'e çevrilir ve uygulama kapandıktan sonra 3 olarak kalır. |
3 |
Loaded |
Başlangıçta yüklenir |
Uygulama, başladığı zaman eklentiyi yüklemeye çalışır. Visual Studio'da bir eklentiyi derlediğinizde veya yayımladığınızda bu varsayılan değerdir. Uygulama eklentiyi başarılı bir şekilde yüklerse LoadBehavior değeri 3 olarak kalır. Eklenti yüklenirken bir hata oluşursa LoadBehavior değeri 2'ye değişir ve uygulama kapandıktan sonra 2 olarak kalır. |
8 |
Unloaded |
İstek halinde yüklenir |
Uygulama eklentiyi otomatik olarak yüklemeye çalışmaz. Kullanıcı eklentiyi el ile yüklemeyi deneyebilir veya eklenti program aracılığıyla yüklenebilir. Uygulama eklentiyi başarılı bir şekilde yüklerse LoadBehavior değeri 9 olarak değişir. |
9 |
Loaded |
İstek halinde yüklenir |
Uygulama, gerektirdiğinde, eklentinin bir UI öğesi kullanıcı tıklattığında, işlevsellik add-in (örneğin, bir özel düğme Şeritte) kullanır gibi yüklenecektir. Uygulama eklentiyi başarılı bir biçimde yüklerse LoadBehavior değeri 9 olarak kalır; fakat, COM Eklentileri iletişim kutusunda eklentinin durumu eklentinin şu anda yüklü olduğunu belirtecek şekilde güncellenir. Eklenti yüklenirken bir hata meydana gelirse LoadBehavior değeri 8 olarak değişir. |
16 |
Loaded |
İlk sefer yüklenir, sonra isteğe bağlı yüklenir |
Eklentinizin istek hâlinde yüklenmesini istiyorsanız bu değeri ayarlayın. Uygulama, kullanıcı onu ilk kez çalıştırdığı zaman eklentiyi yükler. Kullanıcının uygulamayı bir sonraki çalıştırışında, uygulama eklentinin tanımladığı bütün KA öğelerini yükler fakat kullanıcı eklentiyle ilişkili bir KA öğesini tıklamadan eklenti yüklenmez. Uygulama eklentiyi ilk kez başarılı bir biçimde yüklediğinde LoadBehavior değeri eklenti yüklü olduğu sürece 16 olarak kalır. Uygulama kapandıktan sonra LoadBehavior değeri 9' çevrilir. |
Ayrıca bkz.
Kavramlar
Uygulama Düzeyi Eklentisi Mimarisi
Office Çözümleri Yapı İşlemine Genel Bakış
Diğer Kaynaklar
Visual Studio'da Office Çözümleri Mimarisi
Değişiklik Geçmişi
Tarih |
Geçmiş |
Nedeni |
|---|---|---|
|
Mayıs 2010 |
|Vstolocal bildirim girişindeki kullanımı hakkında daha fazla içerik sağladı. |
Bilgi geliştirme. |