VSTO Eklentileri için kayıt defteri girdileri

Makale
01/13/2024

Visual Studio kullanılarak oluşturulan VSTO Eklentilerini dağıtırken belirli bir kayıt defteri girdileri kümesi oluşturmanız gerekir. Bu kayıt defteri girdileri, Microsoft Office uygulaması'nin VSTO Eklentisini bulmasını ve yüklemesini sağlayan bilgiler sağlar.

Şunlar için geçerlidir: Bu konudaki bilgiler VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Not

Office deneyimini birden çok platformda genişleten çözümler geliştirmek mi ilginizi çekiyor? Yeni Office Eklentileri modeline göz atın. Office Eklentileri, VSTO Eklentileri ve çözümleriyle karşılaştırıldığında küçük bir ayak izine sahiptir ve HTML5, JavaScript, CSS3 ve XML gibi neredeyse tüm web programlama teknolojisini kullanarak bunları oluşturabilirsiniz.

Projenizi oluşturduğunuzda, Visual Studio geliştirme bilgisayarında bu kayıt defteri girdilerini oluşturur. Bu, VSTO Eklentisini kolayca çalıştırmanıza ve hatalarını ayıklamanıza yardımcı olur. VSTO Eklentinizi dağıtmak için ClickOnce kullanıldığında kayıt defteri girdileri otomatik olarak son kullanıcı bilgisayarında oluşturulur.

Windows Installer Kullanarak VSTO Çözümü Dağıtma hakkında daha fazla bilgi için bkz . Windows Installer Kullanarak VSTO Çözümü Dağıtma.

VSTO Eklentileri için yükleme işlemi sırasında kayıt defteri girdilerinin nasıl kullanıldığı hakkında daha fazla bilgi için bkz . VSTO Eklentilerinin Mimarisi.

Not

Bu konu başlığında, metin eklentisi kimliği VSTO Eklentiniz için benzersiz bir kimliği temsil eder. Kimlik, varsayılan olarak VSTO Eklenti derlemenizin adıdır.

Geçerli kullanıcı ve tüm kullanıcılar için VSTO Eklentilerini kaydetme

BIR VSTO Eklentisi yüklendiğinde, iki şekilde kaydedilebilir:

Yalnızca geçerli kullanıcı için (VSTO Eklentisi yalnızca Eklenti yüklendiğinde bilgisayarda oturum açmış olan kullanıcı tarafından kullanılabilir). Bu durumda, kayıt defteri girdileri HKEY_CURRENT_USER altında oluşturulur.
Tüm kullanıcılar için (başka bir ifadeyle, bilgisayarda oturum açar tüm kullanıcılar VSTO Eklentisini kullanabilir). Bu durumda, kayıt defteri girdileri HKEY_LOCAL_MACHINE altında oluşturulur.

Visual Studio kullanarak oluşturduğunuz tüm VSTO Eklentileri geçerli kullanıcı için kaydedilebilir. Ancak VSTO Eklentileri yalnızca belirli senaryolarda tüm kullanıcılar için kaydedilebilir. Bu senaryolar bilgisayardaki Microsoft Office sürümüne ve VSTO Eklentisinin nasıl dağıtıldığına bağlıdır.

Dağıtım türü

Bir VSTO Eklentisi dağıtmak için ClickOnce kullanırsanız, VSTO Eklentisi yalnızca geçerli kullanıcı için kaydedilebilir. Bunun nedeni ClickOnce'in yalnızca HKEY_CURRENT_USER altında anahtar oluşturmayı desteklemesidir. Bir VSTO Eklentisini bilgisayardaki tüm kullanıcılara kaydetmek istiyorsanız, VSTO Eklentisini 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 VSTO Eklentisi kayıt defteri girdileri, yüklemenin geçerli kullanıcıya veya tüm kullanıcılara yönelik olup olmadığını bağlı olarak KökHKEY_CURRENT_USER veya HKEY_LOCAL_MACHINE aşağıdaki kayıt defteri anahtarları altında bulunur.

Office Uygulaması	Yapılandırma Yolu
Visio	Root\Software\Microsoft\Visio\Addins\add-in id
Tümü Diğer	Root\Software\Microsoft\Office\Office uygulaması lication name\Addins\add-in id

Not

Yükleyici 64 bit Windows'ta tüm kullanıcıları hedef alıyorsa, biri HKEY_LOCAL_MACHINE\Software\Microsoft ve biri HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft kovanı altında iki kayıt defteri girdisi içermesi önerilir. Bunun nedeni, kullanıcıların bilgisayarda Office'in 32 bit veya 64 bit sürümlerini kullanmasının mümkün olmasıdır.

Yükleyici geçerli kullanıcıyı hedeflediyse, HKEY_CURRENT_USER\Yazılım yolu paylaşıldığından WOW6432Node'a yüklenmesi gerekmez.

Daha fazla bilgi için kayıt defterindeki 32 bit ve 64 bit Uygulama Verileri'ne bakın.

Aşağıdaki tabloda bu kayıt defteri anahtarının altındaki girdiler listelemektedir.

Giriş	Tür	Değer
Açıklama	REG_SZ	Gerekli. VSTO Eklentisinin kısa bir açıklaması. Bu açıklama, kullanıcı Microsoft Office uygulaması lication'daki Seçenekler iletişim kutusunun Eklentiler bölmesinde VSTO Eklentisini seçtiğinde görüntülenir.
Friendlyname	REG_SZ	Gerekli. Microsoft Office uygulaması'de COM Eklentileri iletişim kutusunda görüntülenen VSTO Eklentisinin açıklayıcı adı. Varsayılan değer VSTO Eklenti Kimliği'dir.
Loadbehavior	REG_DWORD	Gerekli. Uygulamanın VSTO Eklentisini ne zaman yüklemeyi denediğini ve VSTO Eklentisinin geçerli durumunu belirten bir değer (yüklendi veya kaldırıldı). Varsayılan olarak, bu girdi 3 olarak ayarlanmıştır ve bu da VSTO Eklentisinin başlangıçta yüklendiğini belirtir. Daha fazla bilgi için bkz . LoadBehavior değerleri. Not: Kullanıcı VSTO Eklentisini devre dışı bırakırsa, bu eylem HKEY_CURRENT_USER kayıt defteri kovanındaki LoadBehavior değerini değiştirir. Her kullanıcı için, HKEY_CURRENT_USER kovandaki LoadBehavior değerinin değeri, HKEY_LOCAL_MACHINE kovanda tanımlanan varsayılan LoadBehavior değerini geçersiz kılar.
Bildirim	REG_SZ	Gerekli. VSTO Eklentisi için dağıtım bildiriminin tam yolu. Yol yerel bilgisayardaki bir konum, bir ağ paylaşımı (UNC) veya bir Web sunucusu (HTTP) olabilir. Çözümü dağıtmak için Windows Installer kullanıyorsanız bildirim yoluna ön ek file:/// eklemeniz gerekir. Bu yolun sonuna \|vstolocal dizesini (yani, vstolocal'ın ardından gelen kanal karakterini\|) de eklemeniz gerekir. Bu, çözümünüzün ClickOnce önbelleği yerine yükleme klasöründen yüklenmesini sağlar. Daha fazla bilgi için bkz . Windows Installer kullanarak Office çözümü dağıtma. Not: Geliştirme bilgisayarında bir VSTO Eklentisi oluşturduğunuzda, Visual Studio otomatik olarak \|vstolocal dizesini bu kayıt defteri girdisine ekler.

Outlook form bölgeleri için kayıt defteri girdileri

Outlook için VSTO Eklentisinde özel form bölgesi oluşturursanız, form bölgesini Outlook'a kaydetmek için ek kayıt defteri girdileri kullanılır. Bu girdiler, form bölgesinin desteklediği her ileti sınıfı için farklı bir kayıt defteri anahtarı altında oluşturulur. Bu kayıt defteri anahtarları, Root'un HKEY_CURRENT_USER veya HKEY_LOCAL_MACHINE olduğu aşağıdaki konumdadır.

Root\Software\Microsoft\Office\Outlook\FormRegions\message sınıfı

Tüm VSTO Eklentileri tarafından paylaşılan diğer kayıt defteri girdileri gibi Visual Studio da projenizi oluştururken geliştirme bilgisayarında form bölgesi kayıt defteri girdilerini oluşturur. VSTO Eklentinizi dağıtmak için ClickOnce kullanıldığında kayıt defteri girdileri otomatik olarak son kullanıcı bilgisayarında oluşturulur. VSTO Eklentinizi dağıtmak için Windows Installer'ı kullandığınızda, InstallShield Limited Edition projesini son kullanıcı bilgisayarında kayıt defteri girdilerini oluşturacak şekilde yapılandırmanız gerekir.

Form bölgesi kayıt defteri girişleri hakkında daha fazla bilgi için bkz . Özel formda form bölgesinin konumunu belirtme. Outlook form bölgeleri hakkında daha fazla bilgi için bkz . Outlook form bölgeleri oluşturma.

LoadBehavior değerleri

Root\Software\Microsoft\Office\application name\Addins\addins\add-in ID anahtarının altındaki LoadBehavior girdisi, VSTO Eklentisinin çalışma zamanı davranışını belirten bit düzeyinde bir değer bileşimi içerir. En düşük sipariş biti (0 ve 1 değerleri), VSTO Eklentisinin şu anda yüklenip yüklenmediğini gösterir. Diğer bitler, uygulamanın VSTO Eklentisini yüklemeyi ne zaman denediğini gösterir.

Genellikle, VSTO Eklentisi son kullanıcı bilgisayarlarına yüklendiğinde LoadBehavior girdisinin 0, 3 veya 16 (ondalık) olarak ayarlanması amaçlanır. Visual Studio, vsto eklentinizi oluştururken veya yayımladığınızda varsayılan olarak LoadBehavior girişini 3 olarak ayarlar.

Aşağıdaki tabloda LoadBehavior girişinin tüm olası değerleri listelemektedir. Bu tablodaki bazı açıklamalar, VSTO Eklentisi'nin el ile veya program aracılığıyla yüklenmesine başvurur. Bir VSTO Eklentisini el ile yüklemek için, uygulamadaki COM Eklentileri iletişim kutusunda VSTO Eklentisi'nin yanındaki onay kutusunu seçin. Bir VSTO Eklentisini program aracılığıyla yüklemek için, VSTO Eklentisini COMAddIn temsil eden nesnenin özelliğini true olarak ayarlayınConnect.

Değer (ondalık)	VSTO Eklenti durumu	VSTO Eklentisi yükleme davranışı	Açıklama
0	Kaldırıldı	Otomatik olarak yüklenme	Uygulama hiçbir zaman VSTO Eklentisini otomatik olarak yüklemeyi denemez. Kullanıcı VSTO Eklentisini el ile yüklemeyi deneyebilir veya VSTO Eklentisi program aracılığıyla yüklenebilir. VSTO Eklentisi başarıyla yüklenirse LoadBehavior değeri 0 olarak kalır, ancak COM Eklentileri iletişim kutusundaki VSTO Eklentisinin durumu VSTO Eklentisinin yüklendiğini gösterecek şekilde güncelleştirilir.
1	Yüklü	Otomatik olarak yüklenme	Uygulama hiçbir zaman VSTO Eklentisini otomatik olarak yüklemeyi denemez. Kullanıcı VSTO Eklentisini el ile yüklemeyi deneyebilir veya VSTO Eklentisi program aracılığıyla yüklenebilir. COM Eklentileri iletişim kutusu, uygulama başlatıldıktan sonra VSTO Eklentisinin yüklendiğini belirtse de, VSTO Eklentisi el ile veya program aracılığıyla yüklenene kadar yüklenmez. Uygulama VSTO Eklentisini başarıyla yüklerse LoadBehavior değeri 0 olarak değişir ve uygulama kapatıldıktan sonra 0'da kalır.
2	Kaldırıldı	Başlangıçta yükle	Uygulama VSTO Eklentisini otomatik olarak yüklemeyi denemez. Kullanıcı VSTO Eklentisini el ile yüklemeyi deneyebilir veya VSTO Eklentisi program aracılığıyla yüklenebilir. Uygulama VSTO Eklentisini başarıyla yüklerse LoadBehavior değeri 3 olarak değişir ve uygulama kapatıldıktan sonra 3'te kalır.
3	Yüklü	Başlangıçta yükle	Uygulama başlatıldığında VSTO Eklentisini yüklemeye çalışır. Visual Studio'da VSTO Eklentisi oluşturduğunuzda veya yayımladığınızda bu varsayılan değerdir. Uygulama VSTO Eklentisini başarıyla yüklerse LoadBehavior değeri 3 olarak kalır. VSTO Eklentisi yüklenirken bir hata oluşursa LoadBehavior değeri 2 olarak değişir ve uygulama kapatıldıktan sonra 2'de kalır.
8	Kaldırıldı	İsteğe bağlı yükleme	Uygulama VSTO Eklentisini otomatik olarak yüklemeyi denemez. Kullanıcı VSTO Eklentisini el ile yüklemeyi deneyebilir veya VSTO Eklentisi program aracılığıyla yüklenebilir. Uygulama VSTO Eklentisini başarıyla yüklerse LoadBehavior değeri 9 olarak değişir.
9	Yüklü	İsteğe bağlı yükleme	VSTO Eklentisi yalnızca uygulama gerektirdiğinde yüklenir. Örneğin, bir kullanıcı VSTO Eklentisi'nde işlevselliği kullanan bir kullanıcı arabirimi öğesi seçtiğinde (örneğin, Şeritteki özel bir düğme). Uygulama VSTO Eklentisini başarıyla yüklerse LoadBehavior değeri 9 olarak kalır, ancak COM Eklentileri iletişim kutusundaki VSTO Eklentisinin durumu VSTO Eklentisinin şu anda yüklü olduğunu gösterecek şekilde güncelleştirilir. VSTO Eklentisi yüklenirken bir hata oluşursa LoadBehavior değeri 8 olarak değişir.
16	Yüklü	İlk kez yükle, ardından isteğe bağlı olarak yükle	VSTO Eklentinizin isteğe bağlı olarak yüklenmesini istiyorsanız bu değeri ayarlayın. Kullanıcı uygulamayı ilk kez çalıştırdığında uygulama VSTO Eklentisini yükler. Kullanıcı uygulamayı bir sonraki çalıştırışında, uygulama VSTO Eklentisi tarafından tanımlanan tüm kullanıcı arabirimi öğelerini yükler. Ancak, kullanıcı VSTO Eklentisi ile ilişkilendirilmiş bir kullanıcı arabirimi öğesi seçene kadar VSTO Eklentisi yüklenmez. Uygulama VSTO Eklentisini ilk kez başarıyla yüklediğinde, VSTO Eklentisi yüklenirken LoadBehavior değeri 16 olarak kalır. Uygulama kapatıldıktan sonra LoadBehavior değeri 9 olarak değişir.