Elemento Snippet (frammenti di codice IntelliSense)
Specifica i riferimenti, gli elementi importati, le dichiarazioni e il codice del frammento di codice.
<Snippet>
<References>... </References>
<Imports>... </Imports>
<Declarations>... </Declarations>
<Code>... </Code>
</Snippet>
Attributi ed elementi
Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.
Attributi
Nessuno.
Elementi figlio
Elemento |
Descrizione |
---|---|
Elemento obbligatorio. Specifica il codice che si desidera inserire in un file di documentazione. In un elemento Snippet deve essere presente esattamente un elemento Code. |
|
Elemento facoltativo. Specifica i valori letterali e gli oggetti che compongono un frammento di codice che è possibile modificare. In un elemento Snippet possono essere presenti zero elementi Declarations oppure uno. |
|
Elemento facoltativo. Raggruppa singoli elementi Import. In un elemento Snippet possono essere presenti zero elementi Imports oppure uno. |
|
Elemento facoltativo. Raggruppa singoli elementi Reference. In un elemento Snippet possono essere presenti zero o un elemento References. |
Elementi padre
Elemento |
Descrizione |
---|---|
Consente di specificare un'intestazione e più frammenti di codice IntelliSense, che è possibile inserire in file di codice Visual Studio. |
Esempio
Nel codice riportato di seguito viene illustrato come utilizzare l'elemento Snippet e i relativi elementi figlio per scrivere un frammento di codice Visual C# con cui viene creato un oggetto SqlDataAdapter.
<CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>Create a data adapter</Title>
<Description>Creates a SqlDataAdapter object.</Description>
<Author>Microsoft Corporation</Author>
<Shortcut>createadapter</Shortcut>
</Header>
<Snippet>
<Declarations>
<Literal>
<ID>SQL</ID>
<ToolTip>Replace with a SQL connection string.</ToolTip>
<Default>"SQL connection string"</Default>
</Literal>
<Object>
<ID>Connection</ID>
<Type>System.Data.SqlClient.SqlConnection</Type>
<ToolTip>Replace with a connection object in your application.</ToolTip>
<Default>dcConnection</Default>
</Object>
</Declarations>
<Code Language="CSharp">
<![CDATA[
daCustomers = new SqlClient.SqlDataAdapter();
selectCommand = new SqlClient.SqlCommand($SQL$);
daCustomers.SelectCommand = selectCommand;
daCustomers.SelectCommand.Connection = $Connection$;
]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>