Özel Uzantılarımı paketleme ve dağıtma (Visual Basic)

  • Makale

Visual Basic, Visual Studio şablonlarını kullanarak özel My ad alanı uzantılarınızı dağıtmanız için kolay bir yol sağlar. Uzantılarınızın My yeni proje türünün ayrılmaz bir parçası olduğu bir proje şablonu oluşturuyorsanız, şablonu dışarı aktarırken özel My uzantı kodunuzu projeye ekleyebilirsiniz. Proje şablonlarını dışarı aktarma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Proje Şablonları Oluşturma.

Özel My uzantınız tek bir kod dosyasındaysa, dosyayı kullanıcıların herhangi bir Visual Basic projesi türüne ekleyebilecekleri bir öğe şablonu olarak dışarı aktarabilirsiniz. Daha sonra bir Visual Basic projesinde özel My uzantınız için ek özellikleri ve davranışları etkinleştirmek üzere öğe şablonunu özelleştirebilirsiniz. Bu özellikler şunlardır:

  • Kullanıcıların Visual Basic Project Tasarım Aracı Uzantılarım sayfasından özel My uzantınızı yönetmesine izin verme.

  • Belirli bir derlemeye başvuru projeye eklendiğinde özel My uzantınızı otomatik olarak ekleme.

  • My Öğe Ekle iletişim kutusundaki uzantı öğesi şablonunu, proje öğeleri listesine eklenmeyecek şekilde gizleme.

Bu konuda, Visual Basic Project Tasarım Aracı Uzantılarım sayfasından yönetilebilen gizli bir öğe şablonu olarak özel My bir uzantının nasıl paketlenebileceği açıklanır. Özel My uzantı, belirli bir derlemeye başvuru bir projeye eklendiğinde de otomatik olarak eklenebilir.

Ad alanım uzantısı oluşturma

Özel My uzantı için dağıtım paketi oluşturmanın ilk adımı, uzantıyı tek bir kod dosyası olarak oluşturmaktır. Özel My uzantı oluşturma hakkında ayrıntılar ve yönergeler için bkz . Visual Basic'te Ad Alanımı Genişletme.

Ad alanım uzantısını öğe şablonu olarak dışarı aktarma

Ad alanı uzantınızı içeren bir kod dosyanız My olduktan sonra, kod dosyasını Visual Studio öğe şablonu olarak dışarı aktarabilirsiniz. Bir dosyayı Visual Studio öğe şablonu olarak dışarı aktarma yönergeleri için bkz . Nasıl yapılır: Öğe Şablonları Oluşturma.

Not

Ad alanı uzantınızın My belirli bir derlemeye bağımlılığı varsa, öğe şablonunuzu söz konusu derlemeye bir başvuru eklendiğinde ad alanı uzantınızı My otomatik olarak yükleyecek şekilde özelleştirebilirsiniz. Sonuç olarak, kod dosyasını Visual Studio öğe şablonu olarak dışarı aktarırken bu derleme başvuruyu dışlamak isteyeceksiniz.

Öğe şablonunu özelleştirme

Öğe şablonunuzun Visual Basic Project Tasarım Aracı Uzantılarım sayfasından yönetilmesini etkinleştirebilirsiniz. Ayrıca, belirli bir derlemeye başvuru projeye eklendiğinde öğe şablonunun otomatik olarak eklenmesini de etkinleştirebilirsiniz. Bu özelleştirmeleri etkinleştirmek için şablonunuza CustomData dosyası adlı yeni bir dosya ekleyecek ve ardından .vstemplate dosyanızdaki XML'ye yeni bir öğe ekleymelisiniz.

CustomData dosyasını ekleme

CustomData dosyası, dosya adı uzantısına sahip bir metin dosyasıdır. CustomData (dosya adı, şablonunuz için anlamlı herhangi bir değere ayarlanabilir) ve XML içerir. CustomData dosyasındaki XML, kullanıcılar Visual Basic Project Tasarım Aracı Uzantılarım sayfasını kullandığında Visual Basic'e uzantınızı My eklemesini bildirir. İsteğe bağlı olarak özniteliğini <AssemblyFullName> CustomData dosya XML'inize ekleyebilirsiniz. Bu, Visual Basic'e projeye belirli bir derlemeye başvuru eklendiğinde özel My uzantınızı otomatik olarak yüklemesini sağlar. CustomData dosyasını oluşturmak ve ardından öğe şablonunuzun sıkıştırılmış klasörüne (.zip dosyası) eklemek için herhangi bir metin düzenleyicisini veya XML düzenleyicisini kullanabilirsiniz.

Örneğin, aşağıdaki XML, Microsoft.VisualBasic.PowerPacks.Vs.dll derlemesine başvuru eklendiğinde şablon öğesini Visual Basic projesinin Uzantılarım klasörüne ekleyecek bir CustomData dosyasının içeriğini gösterir.

<VBMyExtensionTemplate
    ID="Microsoft.VisualBasic.Samples.MyExtensions.MyPrinterInfo"
    Version="1.0.0.0"
    AssemblyFullName="Microsoft.VisualBasic.PowerPacks.vs"
/>

CustomData dosyası, aşağıdaki tabloda listelenen özniteliklere sahip bir <VBMyExtensionTemplate> öğe içerir.

Öznitelik Açıklama
ID Gerekli. Uzantının benzersiz tanımlayıcısı. Bu kimliği içeren uzantı projeye zaten eklenmişse, kullanıcıdan yeniden eklemesi istenmez.
Version Gerekli. Öğe şablonu için sürüm numarası.
AssemblyFullName isteğe bağlı. Derleme adı. Bu derlemeye başvuru projeye eklendiğinde, kullanıcıdan bu öğe şablonundan uzantıyı eklemesi My istenir.

<CustomDataSignature> öğesini .vstemplate dosyasına ekleme

Visual Studio öğe şablonunuzu ad My alanı uzantısı olarak tanımlamak için, öğe şablonunuz için .vstemplate dosyasını da değiştirmeniz gerekir. öğesine bir <CustomDataSignature> öğe <TemplateData> eklemeniz gerekir. <CustomDataSignature> öğesi, aşağıdaki örnekte gösterildiği gibi metnini Microsoft.VisualBasic.MyExtensioniçermelidir.

<CustomDataSignature>Microsoft.VisualBasic.MyExtension</CustomDataSignature>

Sıkıştırılmış bir klasördeki (.zip dosya) dosyaları doğrudan değiştiremezsiniz. Sıkıştırılmış klasörden .vstemplate dosyasını kopyalamanız, değiştirmeniz ve ardından sıkıştırılmış klasördeki .vstemplate dosyasını güncelleştirilmiş kopyanızla değiştirmeniz gerekir.

Aşağıdaki örnek, öğesinin eklendiği bir .vstemplate dosyasının <CustomDataSignature> içeriğini gösterir.

<VSTemplate Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vstemplate/2005" Type="Item">
  <TemplateData>
    <DefaultName>MyCustomExtensionModule.vb</DefaultName>
    <Name>MyPrinterInfo</Name>
    <Description>Custom My Extensions Item Template</Description>
    <ProjectType>VisualBasic</ProjectType>
    <SortOrder>10</SortOrder>
    <Icon>__TemplateIcon.ico</Icon>
    <CustomDataSignature      >Microsoft.VisualBasic.MyExtension</CustomDataSignature>
  </TemplateData>
  <TemplateContent>
    <References />
    <ProjectItem SubType="Code"
                 TargetFileName="$fileinputname$.vb"
                 ReplaceParameters="true"
     >MyCustomExtensionModule.vb</ProjectItem>
  </TemplateContent>
</VSTemplate>

Şablonu yükleme

Şablonu yüklemek için sıkıştırılmış klasörü (.zip dosya) Visual Basic öğe şablonları klasörüne kopyalayabilirsiniz. Varsayılan olarak, kullanıcı öğesi şablonları %USERPROFILE%\Documents\Visual Studio <Version>\Templates\ItemTemplates\Visual Basic konumunda bulunur. Alternatif olarak, şablonu Visual Studio Yükleyicisi (.vsi) dosyası olarak yayımlayabilirsiniz.

Ayrıca bkz.