Uygulama Düzeyi Eklentileri için Kayıt Defteri Girdileri

Makale
02/26/2013

Visual Studio 2012 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 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ü.

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.Eklentinizi dağıtmak için ClickOnce kullanırsanız, kayıt defteri girdileri son kullanıcı bilgisayarında otomatik olarak oluşturulur.Eklentinizi dağıtmak için Windows Installer kullanırsanız, son kullanıcı bilgisayarında kayıt defteri girdileri oluşturmak için InstallShield Limited Edition project yapılandırmanız gerekir.

Kayıt defteri girdileri için eklentileri yükleme işlemi sırasında nasıl kullanılır 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, kimliği, eklenti derlemesinin addır.

Eklentiler vs geçerli kullanıcı için kayıt. tüm kullanıcılar

Eklenti yüklendiğinde, iki yolla kaydedilebilir:

Yalnızca geçerli kullanıcı için (yani, bu eklenti yüklü olan bilgisayarda oturum açan 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 (diğer bir deyişle, bilgisayarda oturum eklenti kullanabilirsiniz herhangi bir kullanıcı).Bu durumda, kayıt defteri girdilerini HKEY_LOCAL_MACHINE altında oluşturulur.

Kullanarak oluşturduğunuz tüm eklentileri Visual Studio 2012 geçerli kullanıcı için kayıtlı olmalıdır.Ancak, bazı senaryolarda yalnızca tüm kullanıcılar için eklentiler kaydedilebilir.Bu senaryolar Microsoft Office sürümü bilgisayarda ve eklentinin nasıl dağıtıldığına göre değişir.

Microsoft Office sürümü

Microsoft Office 2010 ve Microsoft Office 2013 uygulamaları HKEY_LOCAL_MACHINE veya hkey_current_user altında kayıtlı eklentiler yükleyebilirsiniz.

HKEY_LOCAL_MACHINE altında kayıtlı eklentileri yüklemek için bilgisayarların güncelleştirme paketi 976477 yüklü olması gerekir.Daha fazla bilgi için bkz: https://go.microsoft.com/fwlink/?LinkId=184923.

Dağıtım türü

Bir eklentiyi 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 istiyorsanız, eklentiyi dağıtmak için Windows Installer kullanmanız gerekir.Bu dağıtım türleri hakkında daha fazla bilgi için bkz: ClickOnce Kullanarak Office Çözümü Dağıtma ve Windows Installer Kullanarak Office Çözümü Dağıtma.

Kayıt Defteri Girdileri

Gerekli eklenti kayıt defteri girdileri, Visio dışında tüm uygulamalar için aşağıdaki kayıt defteri anahtarı altında bulunur nerede kök HKEY_LOCAL_MACHINE veya hkey_current_user.

Kök\Software\Microsoft\Office\Uygulama adı\Addins\eklentisi kodu

Visio için kayıt defteri girdileri aşağıdaki kayıt defteri anahtarı altında ait.

Kök\Software\Microsoft\Visio\Addins\eklentisi kodu

Aşağıdaki tablo bu kayıt defteri anahtarı altındaki girdileri listeler.

Giriş	Tür	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, önek eklemelisiniz file:/// için bildirim yolu.Dize append gerekir \|vstolocal biçimine sahiptir (yani, dikey çizgi karakteri\|arkasından vstolocal) bu yolun sonuna.Bu, çözümünüzün yükleme klasörü, yerine ClickOnce önbelleğine yüklenir sağlar.Daha fazla bilgi için bkz. Windows Installer Kullanarak Office Çözümü Dağıtma. Not Geliştirme bilgisayarında bir eklenti derlediğinizde, Visual Studio otomatik olarak ekler \|vstolocal biçimine sahiptir bu kayıt defteri girdisi için dize.
Warmup	REG_DWORD	İsteğe Bağlı.Belirten bir değer .NET Framework ve Office için Visual Studio Araçları çalışma zamanı modülü eklenti yükleri önce yüklemek ve bir eklenti yüklemek için algılanan süresini azaltmak.Set Warmup 1 girişi ve birlikte kullanın LoadBehavior Outlook 2010 için yükleme süresini azaltmak için giriş ve Outlook 2013 Windows Installer (.msi) kullanılarak dağıtılan eklentileri.Bu kayıt defteri anahtarı, ClickOnce kullanarak ayarlayamazsınız.

Outlook Form Bölgeleri için Kayıt Defteri Girdileri

Özel form bölgesi bir eklentinin Outlook için oluşturursanız, ek kayıt defteri girdileri form bölgesini Outlook ile 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 yerde kök HKEY_LOCAL_MACHINE veya hkey_current_user.

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.Eklentinizi dağıtmak için ClickOnce kullanırsanız, kayıt defteri girdileri son kullanıcı bilgisayarında otomatik olarak oluşturulur.Eklentinizi dağıtmak için Windows Installer kullanırsanız, son kullanıcı bilgisayarında kayıt defteri girdileri oluşturmak için InstallShield Limited Edition project 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ında giriş kök\Software\Microsoft\Office\Uygulama adı\Addins\eklentinin ID'si anahtar, eklentinin çalışma zamanı davranışlarını belirleyen değerlerin bit seviyesinde 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 giriş için 0, 3 veya 16 (ondalık) olarak ayarlamak için tasarlanmıştır ne zaman eklenti yüklü son kullanıcı bilgisayarları üzerinde.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ışı	Tanımlama
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	Sadece uygulamanın gerekli tuttuğu bir UI öğesine Kullanıcı tıklattığında, işlevselliği eklenti (örneğin, özel bir düğmeye Şerit) kullanır gibi eklenti yüklenir. 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.