Pages

Friday, December 23, 2011

Code Snippets in Visual Studio 2010

Visual Studio allows developers to save snippets of code which can be inserted at a later time. This saves on retyping blocks of code that are used often. I also find it very useful when I have to show code during presentations. Instead of typing everything live, I find it far easier to simply add the code block by block using code snippets.
VS 2010 improves the snippet functionality, and makes it easier to create code snippets. There’s two types of snippets:
- Expansion snippets are inserted at the cursor
- SurroundsWith snippets wraps around selected code

Creating a Custom Snippet:

Let’s go ahead and create a try-catch-finally Expansion snippet:
- Insert a new XML file to the project and call it TryCatchFinally.snippet. Make sure the file name ends with .snippet
- Right-click on the editor window and select Insert Snippet->Snippet. This creates a basic XML snippet template as shown below:
01.<CodeSnippet Format="1.0.0"
03.<Header>
04.<Title>titleTitle>
05.<Author>authorAuthor>
06.<Shortcut>shortcutShortcut>
07.<Description>descriptionDescription>
08.<SnippetTypes>
09.<SnippetType>SurroundsWithSnippetType>
10.<SnippetType>ExpansionSnippetType>
11.SnippetTypes>
12.Header>
13.<Snippet>
14.<Declarations>
15.<Literal>
16.<ID>nameID>
17.<Default>valueDefault>
18.Literal>
19.Declarations>
20.<Code Language="XML">
21.
22.$name$
23.$selected$ $end$]]>
24.Code>
25.Snippet>
26.CodeSnippet>
- As you can see, by default the template contains both snippet types. Since I am creating an Expansion snippet, let’s go ahead and get rid of the SurroundsWith tag.
- Update the Title to "Try Catch Finally", Shortcut to "trycf" and Description to "Adds a try-catch-finally block".
- Literal tag enables us to define editable values that are inserted into the snippet. In the try-catch-finally snippet, we want to allow the user to change the type of the Exception being caught. The ID tag is the name of the editable value so change it to "ExceptionName". The Default tag specifies the default value for our editable field. I want to catch all exceptions, so change the Default tag’s value to "Exception".
- Finally, the code section contains what will be added when the snippet is inserted. Change the language to "CSharp", and the body to the following:

01.<Code Language="CSharp">
02.
03.try
04.{
05. 
06.}
07.catch($ExceptionName$)
08.{
09. 
10.}
11.finally
12.{
13. 
14.}
15.]]>
16.Code>
- The final version of the TryCatchFinally.snippet file is shown below. For more details about the XML schema, take a look at the MSDN code snippets Schema Reference
01.xml version="1.0" encoding="utf-8" ?>
02.<CodeSnippet Format="1.0.0"
04.<Header>
05.<Title>Try Catch FinallyTitle>
06.<Author>umairAuthor>
07.<Shortcut>trycfShortcut>
08.<Description>Adds a try-catch-finally blockDescription>
09.<SnippetTypes>
10.<SnippetType>ExpansionSnippetType>
11.SnippetTypes>
12.Header>
13.<Snippet>
14.<Declarations>
15.<Literal>
16.<ID>ExceptionNameID>
17.<Default>ExceptionDefault>
18.Literal>
19.Declarations>
20.<Code Language="CSharp">
21.
22.try
23.{
24. 
25.}
26.catch($ExceptionName$)
27.{
28. 
29.}
30.finally
31.{
32. 
33.}
34.]]>
35.Code>
36.Snippet>
37.CodeSnippet>

Loading the Snippet into Visual Studio:

There are two ways to insert the above snippet into Visual Studio.
The most straightforward way is to put the .snippet files in VS 2010's code snippets directory. The default location for it is C:\Users\\Documents\Visual Studio 2010\Code Snippets\. This folder contains sub-directories based on the language of the snippet. For my example, the snippet goes under Visual C#. Once put here, VS 2010 automatically picks up the snippets without the need to restart.

The second option is to import the .snippet file into Visual Studio.
- Inside Visual studio, go to Tools->Code Snippets Manager (Ctrl+K,Ctrl+B). This brings up the Snippets Manager.
- Press Import button, and navigate to the location where the snippet was saved. Select the .snippet file.
- Press OK.
 

Using the Code Snippet:

Type the name of the snippet (the shortcut), and pressing tab expands it.

You can also press Ctrl+K and Ctrl+X which brings up the "Insert Snippet" menu as shown below:

We can navigate to My Code Snippets, and select the TryCatchFinally that we’ve just added:

No comments: