Condividi tramite

Creare un pacchetto e distribuire estensioni personali personalizzate (Visual Basic)

Visual Basic offre un modo semplice per distribuire le estensioni dello spazio dei nomi personalizzate My usando i modelli di Visual Studio. Se si sta creando un modello di progetto per cui My le estensioni sono parte integrante del nuovo tipo di progetto, è sufficiente includere il codice di estensione personalizzato My con il progetto quando si esporta il modello. Per altre informazioni sull'esportazione dei modelli di progetto, vedere Procedura: Creare modelli di progetto.

Se l'estensione personalizzata My si trova in un singolo file di codice, è possibile esportare il file come modello di elemento che gli utenti possono aggiungere a qualsiasi tipo di progetto Visual Basic. È quindi possibile personalizzare il modello di elemento per abilitare funzionalità e comportamenti aggiuntivi per l'estensione personalizzata My in un progetto Visual Basic. Tali funzionalità includono quanto segue:

  • Consentire agli utenti di gestire la tua estensione personalizzata dalla pagina My del progettista di progetto di Visual Basic.

  • Aggiungere automaticamente l'estensione personalizzata My quando si aggiunge un riferimento a un assembly specificato a un progetto.

  • Nascondere il My modello di elemento di estensione nella finestra di dialogo Aggiungi elemento in modo che non sia incluso nell'elenco di elementi di progetto.

In questo argomento viene illustrato come impacchettare un'estensione personalizzata My come modello di elemento nascosto che può essere gestito dalla pagina Mie estensioni del Project Designer di Visual Basic. L'estensione personalizzata My può essere aggiunta automaticamente anche quando un riferimento a un assembly specificato viene aggiunto a un progetto.

Creare un'estensione dello spazio dei nomi personale

Il primo passaggio per la creazione di un pacchetto di distribuzione per un'estensione personalizzata My consiste nel creare l'estensione come singolo file di codice. Per informazioni dettagliate e indicazioni su come creare un'estensione personalizzata My , vedere Estensione dello spazio dei nomi personale in Visual Basic.

Esportare un'estensione dello spazio dei nomi My come modello di elemento

Dopo aver creato un file di codice che include l'estensione My dello spazio dei nomi, è possibile esportare il file di codice come modello di elemento di Visual Studio. Per istruzioni su come esportare un file come modello di elemento di Visual Studio, vedere Procedura: Creare modelli di elemento.

Annotazioni

Se l'estensione My dello spazio dei nomi ha una dipendenza da un particolare assembly, è possibile personalizzare il modello di elemento per installare automaticamente l'estensione My dello spazio dei nomi quando viene aggiunto un riferimento a tale assembly. Di conseguenza, è necessario escludere il riferimento all'assembly quando si esporta il file di codice come modello di elemento di Visual Studio.

Personalizzare il modello di elemento

È possibile abilitare il modello di elemento per essere gestito dalla pagina Estensioni personali del Progettista Progetti di Visual Basic. È anche possibile abilitare l'aggiunta automatica del modello di elemento quando un riferimento a un assembly specificato viene aggiunto a un progetto. Per abilitare queste personalizzazioni, aggiungere un nuovo file, denominato file CustomData, al modello e quindi aggiungere un nuovo elemento al codice XML nel file con estensione vstemplate.

Aggiungere il file CustomData

Il file CustomData è un file di testo con estensione di file . CustomData (il nome file può essere impostato su qualsiasi valore significativo per il modello) e che contiene XML. Il codice XML nel file CustomData indica a Visual Basic di includere l'estensione My quando gli utenti usano la pagina Estensioni personali di Progettazione progetti di Visual Basic. Facoltativamente, è possibile aggiungere l'attributo <AssemblyFullName> al file XML customData. In questo modo viene indicato a Visual Basic di installare automaticamente l'estensione personalizzata My quando viene aggiunto un riferimento a un particolare assembly al progetto. È possibile usare qualsiasi editor di testo o editor XML per creare il file CustomData e quindi aggiungerlo alla cartella compressa del modello di elemento (.zip file).

Ad esempio, il codice XML seguente mostra il contenuto di un file CustomData che aggiungerà l'elemento modello alla cartella My Extensions di un progetto Visual Basic quando viene aggiunto un riferimento all'assembly Microsoft.VisualBasic.PowerPacks.Vs.dll al progetto.

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

Il file CustomData contiene un <VBMyExtensionTemplate> elemento con attributi elencati nella tabella seguente.

Attributo Descrizione
ID Obbligatorio. Identificatore univoco per l'estensione. Se l'estensione con questo ID è già stata aggiunta al progetto, all'utente non verrà richiesto di aggiungerlo di nuovo.
Version Obbligatorio. Numero di versione per il modello di elemento.
AssemblyFullName Opzionale. Nome dell'assembly. Quando viene aggiunto un riferimento a questo assembly al progetto, all'utente verrà chiesto di aggiungere l'estensione My da questo modello di elemento.

Aggiungere l'elemento <CustomDataSignature> al file con estensione vstemplate

Per identificare il modello di elemento di Visual Studio come estensione dello spazio dei nomi My, è necessario modificare il file .vstemplate anche per il modello di elemento. È necessario aggiungere un <CustomDataSignature> elemento all'elemento <TemplateData> . L'elemento <CustomDataSignature> deve contenere il testo Microsoft.VisualBasic.MyExtension, come illustrato nell'esempio seguente.

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

Non è possibile modificare direttamente i file in una cartella compressa (.zip file). È necessario copiare il file con estensione vstemplate dalla cartella compressa, modificarlo e quindi sostituire il file con estensione vstemplate nella cartella compressa con la copia aggiornata.

Nell'esempio seguente viene illustrato il contenuto di un file con estensione vstemplate con l'elemento <CustomDataSignature> aggiunto.

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

Installare il modello

Per installare il modello, è possibile copiare la cartella compressa (.zip file) nella cartella Modelli di elementi di Visual Basic. Per impostazione predefinita, i modelli di elemento utente si trovano in %USERPROFILE%\Documents\Visual Studio <Version>\Templates\ItemTemplates\Visual Basic. In alternativa, è possibile pubblicare il modello come file del programma di installazione di Visual Studio (vsi).

Vedere anche

  • Last updated on