.Vsdir Dosyalarını Kullanarak Öğe Ekleme ve Yeni Proje İletişim Kutularına Sihirbazlar Ekleme
Visual Studio eklentileri, Visual Studio 2013'te kullanım dışıdır.Eklentilerinizi VSPackage uzantılarına yükseltmelisiniz.Yükseltme hakkında daha fazla bilgi için bkz: SSS: Eklentileri VSPackage Uzantılarına Dönüştürme.
VSDir dosyası, öğelerini Öğe Ekle ve Yeni Proje iletişim kutularına nasıl görüntüleyeceğine ilişkin bilgi sağlamak amacıyla oluşturduğunuz vsdir uzantısı olan bir metin dosyasıdır.Bilgiler nesnelerin adlarını, ortaya çıkma sıralarını ve onlarla görüntülenen simgeyi içermektedir.Bu öğelerden herhangi birini değiştirebilirsiniz.VSDir dosyaları, Öğe Ekle ve Yeni Proje iletişim kutularına yeni şablonlar veya sihirbazlar eklemek için kullanılır..
Varsayılan bir VSDir dosyası yok.Biri varsa, Visual Studio onu okur ve içeriklerini iletişim kutusuna ekler.Biri yoksa, ardından varsayılan şablonlar ve sihirbazlar görüntülenir.Tek bir dizinde birden fazla VSDir dosyası olabilir ve tüm içerikleri iletişim kutularına eklenir.Genellikle, tek bir VSDir dosyası, birden çok sihirbaz, klasör ve şablon için kayıtlar içerir.Dosyadaki her kayıt yeni bir satır karakteriyle ayrılır.Her kayıttaki alanlar birbirinden dikey çizgi (|) karakterleriyle ayrılır.Kendisi için anlamlı veri bulunmayan isteğe bağlı alan yer tutucu olarak 0 (sıfır) veya boşluk içermelidir.Alanlara girilen dizelerin çevresine çift tırnak girilmesi gerekmez.
VSDir Dosyası Bileşenleri
Aşağıdakiler VSDir dosyaları örnekleridir.İlki İzlenecek yol: Sihirbaz Oluşturma başlığında oluşturulan tek bir sihirbazı belirtmektedir:
MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99
Bir sonraki VSDir dosya örneği her sihirbazın ilgili bilgilerinin yanında çok sayıda sihirbaz .vsz dosyasına başvurur (bu konu içerisinde daha sonra açıklanacaktır).Bunlar, dizelere, harflerden oluşan dizeler değil, kaynak kimlik numaraları olarak başvurmaları bakımından, önceki VSDir dosyasından farklıdır.Ayrıca, GUID'leri DLL'lere başvuruda bulunmak için kullanırlar.
..\..\Projects\csharp building blocks\BusinessFacade.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5015|10|#5022|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|127|0|Project
..\..\Projects\csharp building blocks\BusinessRules.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5016|20|#5023|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|128|0|Project
..\..\Projects\csharp building blocks\DataAccess.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5017|30|#5024|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|129|0|Project
..\..\Projects\csharp building blocks\SystemFrameworks.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5018|40|#5025|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|130|0|Project
..\..\Projects\csharp building blocks\WebService.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5019|50|#5026|{FAE04EC1-301F-11d3-BF4B-00C04F79EFBC}|4547|1|WebService|Web
..\..\Projects\csharp building blocks\WebUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5020|60|#5027|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|131|1|WebUI|web
..\..\Projects\csharp building blocks\WinUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5021|70|#5028|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|132|0|Project
Aşağıdaki alanlar VSDir dosyası içerisindeki her kayıt için belirtilebilir:
Alan |
Anlam |
|---|---|
RelPathName |
Gerekli.Visual Studio yükleme dizini ile ilişkili olan MyWizard.vsz gibi sihirbazın .vsz dosyasının adı. |
{clsidPackage} |
İsteğe bağlı.Yerelleştirilmiş kaynaklar içeren DLL öğesine sahip (Visual C++gibi) bir ürünü temsil eden GUID.Normal olarak, üçüncü taraf sihirbazlara karşılık gelen VSDir dosyaları için bu alan boştur. |
LocalizedName |
İsteğe bağlı.Bu, sihirbaz veya şablonun ve Öğe Ekle iletişim kutusunda gözüken adın yerelleştirilebilir adıdır.Bu, #ResID formunun bir kaynak tanımlayıcısı veya bir dize olabilir. |
SortPriority |
Gerekli.Sihirbazın göreceli önceliğini ve sıralama düzenini temsil eden, en yüksek değer 1 olduğu, bir tamsayı.Örneğin, bu öğe "1" ise , diğer 1s'nin yanında ve tüm 2s veya altının önünde görünür. |
Tanımlama |
Gerekli.Öğe seçildiğinde, Öğe Ekle iletişim kutusunda belireceği gibi şablonun veya sihirbazın yerelleştirilebilir açıklaması.Bu, #ResID formunun bir kaynak tanımlayıcısı veya bir dize olabilir.Yalnızca şablon dosyaları için geçerlidir, klasörler için değil. |
DLLPath veya {clsidPackage} |
Gerekli.Sihirbaz için yüklenecek bir simge içeren bir .dll dosyası olan bir ürünün bir DLL veya EXE dosyasının veya bir GUID'sinin tam yolunu belirtir.Simge, sağlanan IconResourceId'ın kullanılmasıyla bir DLL/EXE dosyasının dışına bir kaynak olarak yüklenir.Bu ayar, belirtilmişse, simge konumu için {clsidPackage}'ı geçersiz kılar.Yalnızca şablon dosyaları için geçerlidir, klasörler için değil. |
IconResourceId |
İsteğe bağlı.Görüntülemek üzere simgeyi belirleyen DLL dosyası içinde bir kaynak tanımlayıcısı.Herhangi bir simge tanımlanmazsa, ortam öğe ile aynı uzantıya sahip bir dosyanın yerine varsayılan simgeyi koyar.Yalnızca şablon dosyaları için geçerlidir, klasörler için değil. |
Bayraklar |
İsteğe bağlı.Bkz. aşağıdaki Flags açıklaması ve tablosu.Yalnızca şablon dosyaları için geçerlidir, klasörler için değil. |
SuggestedBaseName |
Gerekli.Sihirbazın, iletişim kutusundaki Ad alanında gösterilen varsayılan adı.Bu, #ResID formunun bir kaynak tanımlayıcısı veya bir dizedir.Ad benzersiz değilse, ortam adla birlikte bir de tamsayı ekler.Örneğin, MyFile.aspx, MyFile1.aspx olarak değiştirilebilir.Herhangi bir ad sağlanmazsa, "Proje" kullanılır.Yalnızca şablon dosyaları için geçerlidir, klasörler için değil. |
Notlar
Kendisi için anlamlı veri bulunmayan gerekli olmayan alan yer tutucu olarak 0 (sıfır) içermelidir.Yerelleştirilmiş adı sağlanmazsa, göreli yol kullanılır.
Herhangi bir simge tanımlanmazsa, IDE söz konusu uzantıya sahip dosyanın yerine varsayılan simgeyi koyar.
Önerilen başka bir taban adı verilmezse, "Proje" kullanılır.
Bayraklar
Bit tabanlı bayraklar grubu Öğe Ekle iletişim kutusundaki Ad ve Konum alanlarını etkinleştirmek veya devre dışı bırakmak için kullanılır.Yani kullanıcı Ekle menüsünden Yeni Öğe Ekle'yi seçtiğinde, ad ve konumun Şablonlar bölmesinde gösterilip gösterilmeyeceğini proje; ancak kullanıcının ad ve konumu kullanıp kullanamayacağını işaretler belirler.Flags değerini ayrı ayrı değerlerin toplamına ayarlayın.Yani 33 VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DisableLocationField değerine eşittir.
Bayrak adı
Ondalık değer
Tanımlama
VSDIRFLAG_NonLocalTemplate
1
Yerel olmayan kullanıcı arabirimi davranışı ve mekanizmaları kaydetmek için kullanın.
VSDIRFLAG_BlankSolution
2
Boş bir çözüm oluşturun.Bir proje oluşturmayın.
VSDIRFLAG_DisableBrowseButton
4
Bu proje veya öğe için Gözat düğmesini devre dışı bırakın.
VSDIRFLAG_DontAddDefExtension
8
Öğe için sağlanan ada varsayılan bir uzantı eklemeyin. (Bu ayar projeler için geçerli değildir.)
VSDIRFLAG_DisableLocationField
32
Bu proje veya öğe için konum alanını devre dışı bırakın.
VSDIRFLAG_DontInitNameField
4096
Bu proje ya da geçerli bir ada sahip öğe için ad alanını başlatmayın.
VSDIRFLAG_DisableNameField
8192
Bu proje veya öğe için ad alanını devre dışı bırakın.
Ayrıca bkz.
Görevler
Nasıl yapılır: Eklentiler Oluşturma
İzlenecek yol: Sihirbaz Oluşturma
Kavramlar
Sihirbazları Başlatmak için .Vsz Dosyalarını Yapılandırma