연습: 코드 조각 만들기Walkthrough: Creating a Code Snippet

몇 가지 단계로 코드 조각을 만들 수 있습니다.You can create a code snippet with only a few steps. XML 파일을 만들고, 적절한 요소를 입력하고, 코드를 추가하기만 하면 됩니다.All you need to do is create an XML file, fill in the appropriate elements, and add your code to it. 또한 코드에 참조 및 대체 매개 변수를 추가할 수 있습니다.You can also add references and replacement parameters to your code. 코드 조각 관리자(도구, 코드 조각 관리자...)에서 가져오기 단추를 사용하여 Visual Studio 설치에 코드 조각을 추가할 수 있습니다.You can add the snippet to your Visual Studio installation by using the Import button on the Code Snippets Manager (Tools, Code Snippets Manager...).

코드 조각 템플릿Snippet Template

다음은 기본 코드 조각 템플릿입니다.The following is the basic snippet template:

<?xml version="1.0" encoding="utf-8"?>  
<CodeSnippets  
    xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">  
    <CodeSnippet Format="1.0.0">  
        <Header>  
            <Title></Title>  
        </Header>  
        <Snippet>  
            <Code Language="">  
                <![CDATA[]]>  
            </Code>  
        </Snippet>  
    </CodeSnippet>  
</CodeSnippets>

코드 조각을 만들려면To Create a Code Snippet

  1. Visual Studio에서 새 XML 파일을 만들고 위에 표시된 템플릿을 추가합니다.Create a new XML file in Visual Studio and add the template shown above.

  2. 코드 조각의 제목을 입력합니다. 예를 들어 Title 요소에 "Hello World VB"를 입력합니다.Fill in the title of the snippet, e.g. "Hello World VB", in the Title element.

  3. Code 요소의 언어 특성에 코드 조각의 언어를 입력합니다.Fill in the language of the snippet in the Languages attribute of the Code element. 예를 들어 "VB"를 사용합니다.For this example, use "VB".

  4. Code 요소 안의 CDATA 섹션에 일부 코드를 추가합니다. 예를 들어 다음과 같습니다.Add some code in the CDATA section inside the Code element, for example:

    <Code Language="VB">  
        <![CDATA[Console.WriteLine("Hello, World!")]]>  
    </Code>
    
  5. VBCodeSnippet.snippet으로 코드 조각을 저장합니다.Save the snippet as VBCodeSnippet.snippet.

Visual Studio에 코드 조각을 추가하려면To Add a Code Snippet to Visual Studio

  1. 코드 조각 관리자를 사용하여 Visual Studio 설치에 사용자 고유의 코드 조각을 추가할 수 있습니다.You can add your own snippets to your Visual Studio installation by using the Code Snippets Manager. 코드 조각 관리자(도구, 코드 조각 관리자...)를 엽니다.Open the Code Snippets Manager (Tools, Code Snippets Manager...).

  2. 내보내기 단추를 클릭합니다.Click the Import button.

  3. 이전 절차에서 코드 조각을 저장한 위치로 이동하고, 선택하고, 열기를 클릭합니다.Go to the location where you saved the code snippet in the previous procedure, select it, and click Open.

  4. 오른쪽 창의 선택 항목 중에서 코드 조각을 추가할 위치를 선택하라고 묻는 코드 조각 가져오기 대화 상자가 열립니다.The Import Code Snippet dialog opens, asking you to choose where to add the snippet from the choices in the right pane. 선택 사항 중 하나는 내 코드 조각이어야 합니다.One of the choices should be My Code Snippets. 마침, 확인을 차례로 선택하고 클릭합니다.Select it and click Finish, then OK.

  5. 코드 조각이 다음 위치에 복사됩니다.The snippet is copied to the following location:

    %USERPROFILE%\Documents\Visual Studio 2017\Code Snippets\Visual Basic\내 코드 조각%USERPROFILE%\Documents\Visual Studio 2017\Code Snippets\Visual Basic\My Code Snippets

  6. Visual Basic 프로젝트를 열고 코드 파일을 열어 코드 조각을 테스트합니다.Test your snippet by opening a Visual Basic project and opening a code file. 파일의 상황에 맞는 메뉴에서 코드 조각, 코드 조각 삽입을 선택한 다음 내 코드 조각을 선택합니다.In the file choose Snippets, Insert Snippet from the context menu, then My Code Snippets. 내 Visual Basic 코드 조각이라는 코드 조각이 나타납니다.You should see a snippet named My Visual Basic Code Snippet. 폴더를 두 번 클릭합니다.Double-click it.

    Console.WriteLine("Hello, World!")이 코드 파일에 삽입됩니다.Console.WriteLine("Hello, World!") is inserted in the code file.

설명 및 바로 가기 필드 추가Adding Description and Shortcut Fields

  1. 설명 필드는 코드 조각 관리자에서 볼 때 코드 조각에 대한 자세한 정보를 제공합니다.Description fields give more information about your code snippet when viewed in the Code Snippets Manager. 바로 가기는 코드 조각을 삽입하기 위해 사용자가 입력할 수 있는 태그입니다.The shortcut is a tag that users can type in order to insert your snippet. 파일 %USERPROFILE%\Documents\Visual Studio 2017\Code Snippets\Visual Basic\My Code Snippet\VBCodeSnippet.snippet을 열어 추가한 코드 조각을 편집합니다.Edit the snippet you have added by opening the file %USERPROFILE%\Documents\Visual Studio 2017\Code Snippets\Visual Basic\My Code Snippet\VBCodeSnippet.snippet.

  2. Header 요소에 Author 및 Description 요소를 추가하고 채웁니다.Add Author and Description elements to the Header element, and fill them in.

  3. Header 요소는 다음과 비슷합니다.The Header element should look something like this:

    <Header>  
        <Title>Hello World VB</Title>  
        <Author>Myself</Author>  
        <Description>Says Hello to the world.</Description>  
    </Header>
    
  4. 코드 조각 관리자를 열고 코드 조각을 선택합니다.Open the Code Snippets Manager and select your code snippet. 오른쪽 창에서 이제 Description 및 Author 필드가 채워졌습니다.In the right pane you should see that the Description and Author fields are now populated.

  5. 바로 가기를 추가하려면 Author 및 Description 요소와 함께 Shortcut 요소를 추가합니다.To add a shortcut, add a Shortcut element alongside the Author and Description element:

    <Header>  
        <Title>Hello World VB</Title>  
        <Author>Myself</Author>  
        <Description>Says Hello to the world.</Description>  
        <Shortcut>hello</Shortcut>  
    </Header>
    
  6. 코드 조각 파일을 다시 저장합니다.Save the snippet file again.

  7. 바로 가기를 테스트하려면 Visual Basic 프로젝트를 열고 코드 파일을 엽니다.To test the shortcut, open a Visual Basic project and open a code file. 파일에 hello를 입력하고 키를 두 번 누릅니다.Type hello in the file and press Tab twice.

    코드 조각이 삽입됩니다.The snippet code is inserted.

참조 및 가져오기를 추가하려면To Add References and Imports

  1. References 요소를 사용하여 프로젝트에 참조를 추가하고 Imports 요소를 사용하여 가져오기 선언을 추가할 수 있습니다.You can add a reference to a project by using the References element, and add an Imports declaration by using the Imports element. (이는 C#에 대해서도 작동합니다.) 예를 들어 코드 예제에서 Console.WriteLineMessageBox.Show로 변경하는 경우 System.Windows.Forms.dll 어셈블리를 프로젝트에 추가해야 합니다.(This works for C# as well.) For example, if you change Console.WriteLine in the code example to MessageBox.Show, you may need to add the System.Windows.Forms.dll assembly to the project.

  2. 코드 조각을 엽니다.Open your snippet.

  3. Snippet 요소 아래에 References 요소를 추가합니다.Add the References element under the Snippet element:

    <References>  
        <Reference>  
            <Assembly>System.Windows.Forms.dll</Assembly>  
        </Reference>  
    </References>
    
  4. Snippet 요소 아래에 Imports 요소를 추가합니다.Add the Imports element under the Snippet element:

    <Imports>  
        <Import>  
           <Namespace>System.Windows.Forms</Namespace>  
        </Import>  
    </Imports>
    
  5. CDATA 섹션을 다음과 같이 변경합니다.Change the CDATA section to the following:

    <![CDATA[MessageBox.Show("Hello, World!")]]>  
    
  6. 코드 조각을 저장합니다.Save the snippet.

  7. Visual Basic 프로젝트를 열고 코드 조각을 추가합니다.Open a Visual Basic project and add the snippet.

  8. 코드 파일 맨 위에 Imports문이 표시됩니다.You will see an Imports statement at the top of the code file:

    Imports System.Windows.Forms
    
  9. 프로젝트의 속성을 봅니다.Look at the project's properties. References 탭은 System.Windows.Forms.dll에 대한 참조를 포함합니다.The References tab includes a reference to System.Windows.Forms.dll.

대체 추가Adding Replacements

  1. 변수를 추가하고 사용자가 현재 프로젝트의 변수로 변수를 교체하도록 하려는 경우 코드 조각의 부분을 사용자가 바꿀 수 있습니다.You may want parts of your code snippets to be replaced by the user, for example if you add a variable and want the user to replace the variable with one in the current project. 두 가지 유형의 대체(리터럴 및 개체)를 제공할 수 있습니다.You can provide two types of replacements: literals and objects. 리터럴은 일부 형식(문자열 리터럴, 변수 이름 또는 숫자 값의 문자열 표현)의 문자열입니다.Literals are strings of some type (string literals, variable names, or string representations of numeric values). 개체는 문자열이 아닌 일부 형식의 인스턴스입니다.Objects are instances of some type other than a string. 이 절차에서는 리터럴 대체 및 개체 대체를 선언하고 이러한 대체를 참조하도록 코드를 변경합니다.In this procedure you will declare a literal replacement and an object replacement, and change the code to reference these replacements.

  2. 코드 조각을 엽니다.Open your snippet.

  3. 이 예제에서는 SQL 연결 문자열을 사용하므로 적절한 참조를 추가하려면 Imports 및 References 요소를 변경해야 합니다.This example uses a SQL connection string, so you need to change the Imports and References elements to add the appropriate references:

    <References>  
        <Reference>  
            <Assembly>System.Data.dll</Assembly>  
        </Reference>  
        <Reference>  
            <Assembly>System.Xml.dll</Assembly>  
        </Reference>  
    </References>  
    <Imports>  
        <Import>  
            <Namespace>System.Data</Namespace>  
        </Import>  
        <Import>  
            <Namespace>System.Data.SqlClient</Namespace>  
        </Import>  
    </Imports>
    
  4. SQL 연결 문자열에 대한 리터럴 대체를 선언하려면 Snippet 요소 아래에 Declarations 요소를 추가하고, ID, 도구 설명 및 대체에 대한 기본값에 대한 하위 요소로 Literal 요소를 추가합니다.To declare a literal replacement for the SQL connection string, add a Declarations element under the Snippet element, and in it add a Literal element with subelements for the ID, the tooltip, and the default value for the replacement:

    <Declarations>  
        <Literal>  
            <ID>SqlConnString</ID>  
            <ToolTip>Replace with a SQL connection string.</ToolTip>  
            <Default>"SQL connection string"</Default>  
        </Literal>  
    </Declarations>
    
  5. SQL 연결에 대한 개체 대체를 선언하려면 Declarations 요소 내에 Object 요소를 추가하고, ID, 개체 유형, 도구 설명 및 기본값에 대한 하위 요소를 추가합니다.To declare an object replacement for the SQL connection, add an Object element inside the Declarations element, and add sub-elements for the ID, the type of the object, the tooltip, and the default value. 결과 Declarations 요소는 다음과 같이 표시됩니다.The resulting Declarations element should look like this:

    <Declarations>  
        <Literal>  
            <ID>SqlConnString</ID>  
            <ToolTip>Replace with a SQL connection string.</ToolTip>  
            <Default>"SQL connection string"</Default>  
        </Literal>  
        <Object>  
            <ID>SqlConnection</ID>  
            <Type>System.Data.SqlClient.SqlConnection</Type>  
            <ToolTip>Replace with a connection object in your application.</ToolTip>  
            <Default>dcConnection</Default>  
        </Object>  
    </Declarations>  
    
  6. 코드 섹션에서 주변 $ 기호로 대체를 참조합니다(예: $replacement$).In the code section, you reference the replacements with surrounding $ signs, for example $replacement$:

    <Code Language="VB" Kind="method body">  
        <![CDATA[Dim daCustomers As SqlDataAdapter  
            Dim selectCommand As SqlCommand  
    
            daCustomers = New SqlClient.SqlDataAdapter()  
            selectCommand = new SqlClient.SqlCommand($SqlConnString$)  
            daCustomers.SelectCommand = selectCommand  
            daCustomers.SelectCommand.Connection = $SqlConnection$]]>  
    </Code>  
    
  7. 코드 조각을 저장합니다.Save the snippet.

  8. Visual Basic 프로젝트를 열고 코드 조각을 추가합니다.Open a Visual Basic project and add the snippet.

  9. 코드는 다음과 같아야 합니다. 여기서 대체 SQL connection stringdcConnection은 연한 주황색으로 강조 표시됩니다.The code should look like the following, where the replacements SQL connection string and dcConnection are highlighted in light orange. 키를 선택하여 서로 간에 이동합니다.Choose Tab to navigate from one to the other.

    Dim daCustomers As SqlDataAdapter  
    Dim selectCommand As SqlCommand  
    
    daCustomers = New SqlClient.SqlDataAdapter()  
    selectCommand = New SqlClient.SqlCommand("SQL connection string")  
    daCustomers.SelectCommand = selectCommand  
    daCustomers.SelectCommand.Connection = dcConnection
    

참고 항목See Also

코드 조각 스키마 참조Code Snippets Schema Reference