Aracılığıyla paylaş

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

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 Proje Tasarımcısı'nın My sayfasından özel uzantınızı yönetmesine izin verme.

  • Belirli bir derlemeye referans eklendiğinde, özel My uzantınızı projeye otomatik olarak ekleme.

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

Bu konu başlığı altında, Visual Basic Proje Tasarımcısı'nın My sayfasından yönetilebilen gizli bir öğe şablonu olarak özel 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.

Kendi ad alanı uzantınızı oluşturun

Ö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.

Uyarı

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 Proje Tasarımcısı'nın 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 Proje Tasarımcısı'nın My sayfasını kullanırken Visual Basic'e uzantınızı 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 için herhangi bir metin düzenleyicisini veya XML düzenleyicisini kullanabilir ve sonra bunu öğe şablonunuzun sıkıştırılmış klasörüne (.zip dosyası) ekleyebilirsiniz.

Ö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.

Özellik 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 Opsiyonel. Birleştirme adı. Bu derlemeye başvuru projeye eklendiğinde, kullanıcıdan bu öğe şablonundan My uzantısını eklemesi 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. <CustomDataSignature> öğesine bir <TemplateData> öğesi 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, <CustomDataSignature> öğesinin eklendiği bir .vstemplate dosyasının 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 bakınız

  • Last updated on