Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Save more on your purchases now! discount-offer-chevron-icon
Savings automatically calculated. No voucher code required.
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Conferences
Free Learning
Arrow right icon
Arrow up icon
GO TO TOP
Visual Studio 2013 Cookbook

You're reading from   Visual Studio 2013 Cookbook Understanding the latest features of Visual Studio can speed up and streamline your projects. And there's no better learning tool than this collection of focused recipes that gives you the fast, hands-on experience you need.

Arrow left icon
Product type Paperback
Published in Mar 2014
Publisher Packt
ISBN-13 9781782171966
Length 332 pages
Edition Edition
Languages
Arrow right icon
Toc

Table of Contents (17) Chapters Close

Visual Studio 2013 Cookbook
Credits
About the Authors
About the Reviewers
www.PacktPub.com
Preface
1. Discovering Visual Studio 2013 2. Getting Started with Windows Store Applications FREE CHAPTER 3. Web Development ā€“ ASP.NET, HTML5, CSS, and JavaScript 4. .NET Framework 4.5.1 Development 5. Debugging Your .NET Application 6. Asynchrony in .NET 7. Unwrapping C++ Development 8. Working with Team Foundation Server 2013 9. Languages Visual Studio Medley Index

Creating your own snippets


Visual Studio snippets are a great way to quickly write repetitive chunks of code using the same basic structure and can save you a lot of time and typing. Snippets have been extended to work on more than just standard code files, and should be considered whenever you find yourself writing similar code over and over. Using snippets can save time and reduce the possibility of bugs: write the code correctly once and then re-use.

For example, you may want to generate a class signature that inherits from a specific base class you use in your application, or you may have a certain attribute that needs to be placed above method calls to enable logging, or you may have specific IDs you want to use in HTML elements to ensure CSS styles can be consistently applied to your web pages. Unfortunately, out of the box Visual Studio still doesn't have a built-in way of authoring snippets. Therefore, you will need to write some XML. Fortunately, it only takes a few minutes to create a snippet, and the time you can save once it exists makes it worth doing.

This recipe will show you how to create your own snippets and make them available inside Visual Studio.

Getting ready

Simply start Visual Studio 2013 and you're ready to go.

How to do it...

Create your own snippet using the following steps:

  1. From the menu, choose File | New | File..., select XML File, and click on Open.

  2. Populate the file using the following XML code:

    <?xml version="1.0" encoding="utf-8"?>
    <CodeSnippets
    xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
      <CodeSnippet Format="1.0.0.">
        <Header>
          <Title>Wrap text in a span</Title>
          <Shortcut>spanned</Shortcut>
          <SnippetTypes>
            <SnippetType>Expansion</SnippetType>
            <SnippetType>SurroundsWith</SnippetType>
          </SnippetTypes>
        </Header>
        <Snippet>
          <Declarations>
            <Literal>
              <ID>id</ID>
              <Default>elementId</Default>
            </Literal>
          </Declarations>
          <Code Language="HTML">
            <![CDATA[<span id="$id$">$selected$</span> is now in a span!]]>
          </Code>
        </Snippet>
      </CodeSnippet>
    </CodeSnippets>
  3. Save the file as spanned text.snippet in your Documents folder.

  4. From the menu, select Tools | Code Snippets Manager.... The shortcut is Ctrl + K, Ctrl + B.

    Tip

    If you are using Virtual Studio Express for Windows and cannot locate the Code Snippets Manager... on your menu, enable Expert Settings via Tools | Settings | Expert Settings.

  5. Click on the Import... button. Select the file you saved in step 3 and click on OK.

  6. Leave the location as My HTML Snippets, as suggested, and click on Finish. The snippet file will automatically be copied to the appropriate location in Documents\Visual Studio 2013\Code Snippets.

  7. In the Code Snippets Manager, change the Language to HTML and expand the My HTML Snippets location, as seen in the following screenshot, to confirm your snippet has been loaded. After confirming this, click on OK to close the dialog.

  8. From the menu, select File | New | File..., then select General | HTML Page, and click on Open.

  9. In the content of the body tag, enter <p>this is some text</p>.

  10. Select the words is some, right-click on the selection, choose Surround With..., then My HTML Snippets | Wrap text in a span, and hit Enter.

  11. The snippet will be expanded and the contents of the id attribute for the span will be selected. Enter the text myId to replace the highlighted elementId placeholder and hit Enter. The cursor will move to the end of the closing span tag.

How it works...

The Header section is where the display title of the snippet is given, a shortcut name (in this case spanned), a human-friendly description, and what type of snippet is being defined. Our example is in the Expansion and SurroundsWith categories. This means our snippet can be used with the selected text (SurroundsWith) or at the cursor's current position in the editor (Expansion).

The Snippet section is where the bulk of the work is done. Visual Studio automatically scanned the code body of the snippet for an identifier placeholder of $id$ so that it could populate it with the default value and prompt you for your own value.

By declaring the snippet as a SurroundsWith snippet, the selected text is passed to the $selected$ placeholder in the body. Since Expansion is also supported, if you enter the snippet on a blank line, Visual Studio will still just generate the following text:

<span id="elementId"></span> is now in a span!

There's moreā€¦

There is a Snippet Designer project on CodePlex (http://snippetdesigner.codeplex.com/) that offers a GUI tool to make creating snippets much easier. It also enables you to select a section of code and export that as a snippet so that you have an easy starting point for making your own custom snippets.

Remember that snippets are more than just a simple text entry/replacement mechanism, and it's worth spending a little time looking through the full schema reference for snippets on MSDN at http://msdn.microsoft.com/en-us/library/ms171418(v=vs.120).aspx to get a better idea of what they can do for you.

lock icon The rest of the chapter is locked
Register for a free Packt account to unlock a world of extra content!
A free Packt account unlocks extra newsletters, articles, discounted offers, and much more. Start advancing your knowledge today.
Unlock this book and the full library FREE for 7 days
Get unlimited access to 7000+ expert-authored eBooks and videos courses covering every tech area you can think of
Renews at $19.99/month. Cancel anytime