Megosztás a következőn keresztül:

Egyéni saját bővítmények (Visual Basic) csomagolása és üzembe helyezése

A Visual Basic egyszerű módot kínál az egyéni My névtérbővítmények Visual Studio-sablonok használatával történő üzembe helyezésére. Ha olyan projektsablont hoz létre, amelyhez a My bővítmények az új projekttípus szerves részét képezik, a sablon exportálásakor egyszerűen hozzáadhatja az egyéni My bővítménykódot a projekthez. További információ a projektsablonok exportálásáról : Útmutató: Projektsablonok létrehozása.

Ha az egyéni My bővítmény egyetlen kódfájlban található, exportálhatja a fájlt elemsablonként, amelyet a felhasználók bármilyen Visual Basic-projekthez hozzáadhatnak. Ezután testre szabhatja az elemsablont, hogy további képességeket és viselkedést biztosíthasson az egyéni My bővítményhez egy Visual Basic-projektben. Ezek a képességek a következők:

  • Lehetővé teszi a felhasználók számára az egyéni My bővítmény kezelését a Visual Basic Project Designer Saját bővítmények lapján.

  • Ha egy adott szerelvényre mutató hivatkozást ad hozzá egy projekthez, automatikusan hozzáadja az egyéni My bővítményt.

  • Elrejti a My bővítményelem-sablont az Elem hozzáadása párbeszédpanelen, hogy az ne szerepel a projektelemek listájában.

Ez a témakör azt ismerteti, hogyan csomagolhat be egyéni My bővítményeket rejtett elemsablonként, amelyeket a Visual Basic Project Designer Saját bővítmények lapján lehet kezelni. Az egyéni My bővítmény automatikusan is hozzáadható, ha egy adott szerelvényre mutató hivatkozást ad hozzá egy projekthez.

Saját névtér bővítmény létrehozása

Az egyéni My bővítmény üzembehelyezési csomagjának létrehozásának első lépése a bővítmény egyetlen kódfájlként való létrehozása. Az egyéni My bővítmények létrehozásával kapcsolatos részletekért és útmutatásért lásd : A My Namespace kiterjesztése a Visual Basicben.

Saját névtérbővítmény exportálása elemsablonként

Miután rendelkezik a névtérkiterjesztést tartalmazó My kódfájllal, exportálhatja a kódfájlt Visual Studio-elemsablonként. A fájlok Visual Studio-elemsablonként való exportálására vonatkozó utasításokért lásd: Elemsablonok létrehozása.

Megjegyzés:

Ha a My névtérkiterjesztés függőséget jelent egy adott szerelvényhez, testre szabhatja az elemsablont, hogy automatikusan telepítse a névtérkiterjesztést az My adott szerelvényre mutató hivatkozás hozzáadásakor. Ennek eredményeképpen a kódfájl Visual Studio-elemsablonként való exportálásakor ki kell zárnia ezt a szerelvényhivatkozást.

Az elemsablon testreszabása

Engedélyezheti az elemsablon kezelését a Visual Basic Project Designer Saját bővítmények lapján. Azt is engedélyezheti, hogy az elemsablon automatikusan hozzá legyen adva, amikor egy adott szerelvényre mutató hivatkozást ad hozzá egy projekthez. A testreszabások engedélyezéséhez hozzáad egy új fájlt, a CustomData fájlt a sablonhoz, majd hozzáad egy új elemet az XML-hez a .vstemplate fájlban.

A CustomData-fájl hozzáadása

A CustomData fájl olyan szövegfájl, amelynek fájlnévkiterjesztése a következő: . CustomData (a fájlnév bármilyen, a sablon számára értelmezhető értékre beállítható), amely XML-t tartalmaz. A CustomData fájl XML-je arra utasítja a Visual Basicet, hogy vegye fel a My bővítményt, amikor a felhasználók a Visual Basic Project Designer Saját bővítmények lapját használják. Igény szerint hozzáadhatja az attribútumot a <AssemblyFullName> CustomData fájl XML-fájljához. Ez arra utasítja a Visual Basicet, hogy automatikusan telepítse az egyéni My bővítményt, amikor egy adott szerelvényre mutató hivatkozást ad hozzá a projekthez. Bármilyen szövegszerkesztővel vagy XML-szerkesztővel létrehozhatja a CustomData-fájlt, majd hozzáadhatja az elemsablon tömörített mappájához (.zip fájlhoz).

Az alábbi XML például egy CustomData-fájl tartalmát jeleníti meg, amely hozzáadja a sablonelemet egy Visual Basic-projekt Saját bővítmények mappájába, amikor a projekthez hozzáad egy Microsoft.VisualBasic.PowerPacks.Vs.dll szerelvényre mutató hivatkozást.

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

A CustomData fájl egy <VBMyExtensionTemplate> olyan elemet tartalmaz, amely az alábbi táblázatban felsorolt attribútumokkal rendelkezik.

Jellemző Leírás
ID Szükséges. A bővítmény egyedi azonosítója. Ha az azonosítót tartalmazó bővítmény már hozzá lett adva a projekthez, a rendszer nem kéri a felhasználót, hogy adja hozzá újra.
Version Szükséges. Az elemsablon verziószáma.
AssemblyFullName Opcionális. Szerelvény neve. Amikor a projekthez hozzáad egy erre a szerelvényre mutató hivatkozást, a rendszer kérni fogja a felhasználót, hogy adja hozzá a bővítményt ebből az My elemsablonból.

<CustomDataSignature> Az elem hozzáadása a .vstemplate fájlhoz

A Visual Studio-elemsablon névtérkiterjesztésként My való azonosításához módosítania kell az elemsablon .vstemplate fájlját is. Hozzá kell adnia egy <CustomDataSignature> elemet az <TemplateData> elemhez. Az <CustomDataSignature> elemnek tartalmaznia kell a szöveget Microsoft.VisualBasic.MyExtensionaz alábbi példában látható módon.

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

Tömörített mappában (.zip fájlban) közvetlenül nem módosíthatja a fájlokat. Másolja a .vstemplate fájlt a tömörített mappából, módosítsa, majd cserélje le a tömörített mappában lévő .vstemplate fájlt a frissített példányra.

Az alábbi példa bemutatja a .vstemplate-fájl tartalmát, amelyhez hozzáadták a <CustomDataSignature> elemet.

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

A sablon telepítése

A sablon telepítéséhez másolja a tömörített mappát (.zip fájlt) a Visual Basic elemsablonok mappájába. Alapértelmezés szerint a felhasználói elemsablonok a%USERPROFILE%\Documents\Visual Studio <Version>\Templates\ItemTemplates\Visual Basic mappában találhatók. A sablont Visual Studio Installer-fájlként (.vsi) is közzéteheti.

Lásd még

  • Last updated on