Procedura: creare un frammento di codice di base

Articolo
09/12/2008

Aggiornamento: novembre 2007

I frammenti di codice IntelliSense sono file XML con estensione .snippet che aderiscono allo schema XML dei frammenti di codice IntelliSense. In questo argomento verrà creato un frammento di codice di base che consente di visualizzare una finestra di messaggio. Per ulteriori informazioni sullo schema XML dei frammenti di codice, vedere Riferimento dello schema dei frammenti di codice.

Creazione di un file .snippet

Prima di poter iniziare a scrivere il frammento di codice, è necessario creare un file XML con estensione .snippet.

Per creare un file .snippet

Scegliere Nuovo dal menu File, quindi fare clic su File.
Fare clic su File XML, quindi scegliere Apri.
Scegliere Salva <NomeFileXML> dal menu File.
Nella finestra Salva come selezionare Tutti i file (*.*).
Nella casella Nome file, immettere un nome di file con estensione .snippet.
Scegliere Salva.

Scrittura del codice

Una volta creato il file XML, è necessario scrivere il codice XML che costituisce il frammento di codice. Per ulteriori informazioni sugli elementi XML utilizzati negli esempi riportati di seguito, vedere Riferimento dello schema dei frammenti di codice.

Per scrivere il codice relativo al frammento

Sotto la riga di codice XML generata automaticamente, aggiungere un elemento CodeSnippets con il valore di attributo xmlns appropriato e un elemento CodeSnippet per creare un singolo frammento di codice. Di seguito è riportato un esempio:
```
<CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
```
Aggiungere una sezione di intestazione al frammento di codice. Di seguito è riportato un esempio:
```
<Header>
    <Title>
        My Snippet
    </Title>
</Header>
```
Aggiungere gli elementi che definiscono il frammento di codice stesso. Nell'esempio riportato di seguito, il linguaggio del frammento di codice è Visual Basic.
```
<Snippet>
    <Code Language="VB">

    </Code>
</Snippet>
```
Nota:

L'attributo Language accetta anche i valori CSharp, VJSharp e XML. Per ulteriori informazioni, vedere Elemento Code (frammenti di codice IntelliSense).
All'interno dell'elemento Code, aggiungere il codice Visual Basic per il frammento. Tutto il codice dei frammenti deve essere racchiuso tra le parentesi <![CDATA[ e ]]>. Nell'esempio riportato di seguito, il codice che verrà inserito è MessageBox.Show("Hello World").
```
<Code Language="VB">
    <![CDATA[MessageBox.Show("Hello World")]]>
</Code>
```
All'interno dell'elemento Snippet, aggiungere l'elemento References e tutti gli elementi figlio richiesti che consentono di aggiungere un riferimento al progetto quando viene inserito il frammento di codice. In questo esempio, il frammento di codice aggiunge un riferimento a System.Windows.Forms.dll quando viene inserito il frammento.

Nota:

Solo i frammenti di codice Visual Basic supportano la sezione References. Per i frammenti di codice in altri linguaggi occorre aggiungere manualmente i riferimenti corretti.
```
<Snippet>
    <References>
        <Reference>
            <Assembly>System.Windows.Forms.dll</Assembly>
        </Reference>
    </References>
    <Code Language="VB">
        <![CDATA[MessageBox.Show("Hello World")]]>
    </Code>
</Snippet>
```

Nota:
L'attributo Language accetta anche i valori CSharp, VJSharp e XML. Per ulteriori informazioni, vedere Elemento Code (frammenti di codice IntelliSense).

Nota:
Solo i frammenti di codice Visual Basic supportano la sezione References. Per i frammenti di codice in altri linguaggi occorre aggiungere manualmente i riferimenti corretti.

A questo punto, è possibile utilizzare il frammento di codice IntelliSense in Visual Studio 2005 seguendo le procedure descritte in Procedura: gestire frammenti di codice e Procedura: inserire frammenti di codice IntelliSense.

Esempio

L'esempio riportato di seguito contiene l'intero frammento di codice IntelliSense creato nei passaggi precedenti.

<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>
                My Snippet
            </Title>
        </Header>
        <Snippet>
            <References>
                <Reference>
                    <Assembly>System.Windows.Forms.dll</Assembly>
                </Reference>
            </References>
            <Code Language="VB">
                <![CDATA[MessageBox.Show("Hello World")]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

L'esempio riportato di seguito contiene una versione Visual C# del frammento di codice IntelliSense creato nei passaggi precedenti. I frammenti di codice Visual C# non supportano la sezione References, pertanto il riferimento a System.Windows.Forms.dll dovrà essere aggiunto manualmente al progetto.

<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>
                My Snippet
            </Title>
        </Header>
        <Snippet>
            <Code Language="CSharp">
                <![CDATA[MessageBox.Show("Hello World");]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>