다음을 통해 공유

연습: Visual Studio에서 코드 조각 만들기

코드 조각을 사용하여 반복 코드를 입력하거나 샘플을 검색하는 데 걸리는 시간을 줄여 생산성과 안정성을 높일 수 있습니다. 코드 조각은 애플리케이션에 삽입할 준비가 된 사전 인증된 코드 조각입니다.

사용자 고유의 코드 조각을 만들고 Visual Studio에 이미 포함된 코드 조각에 추가할 수 있습니다. 이 문서에서는 몇 단계만에 코드 조각을 만드는 방법을 안내합니다. XML 파일을 만들고, 적절한 요소를 입력하고, 파일에 코드를 추가합니다. 필요에 따라 대체 매개 변수 및 프로젝트 참조를 사용할 수 있습니다. 그런 다음, 코드 조각을 Visual Studio 설치로 가져옵니다.

코드 조각 만들기

  1. Visual Studio를 열고 시작 화면에서 코드 없이 계속을 선택합니다.

    코드 없이 계속 옵션이 선택된 시작 창의 스크린샷

  2. 메뉴 모음에서 새 파일 파일을> 선택하거나 Ctrl+N을 입력합니다.

  3. 새 파일 대화 상자에서 XML 파일을 선택한 다음 열기를 선택합니다.

    XML 파일 옵션이 선택된 새 파일 대화 상자의 스크린샷.

  4. 다음 기본 코드 조각 템플릿을 코드 편집기에 붙여넣습니다.

    <?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>

  5. 코드 조각 Title 요소에 제곱근 제목을 입력합니다.

  6. Language 요소의 Code 특성에서 C# 코드 조각에 대한 CSharp 또는 Visual Basic용 VB를 입력합니다.

    팁 (조언)

    사용 가능한 모든 언어 값을 보려면 코드 조각 스키마 참조의특성을 참조하세요.

  7. 요소 내의 섹션에 CDATA 다음 코드 조각을 추가합니다 Code .

    C#의 경우:

        <![CDATA[double root = Math.Sqrt(16);]]>

    Visual Basic의 경우:

        <![CDATA[Dim root = Math.Sqrt(16)]]>

    비고

    코드 조각의 섹션에서 코드 CDATA 줄의 서식을 지정하거나 들여쓰는 방법을 지정할 수 없습니다. 삽입 시 언어 서비스는 삽입된 코드의 서식을 자동으로 지정합니다.

  8. 스니펫을 SquareRoot.snippet으로 저장합니다.

코드 조각 가져오기

  1. 코드 조각을 Visual Studio 설치로 가져오려면 도구>코드 조각 관리자 를 선택하거나 Ctrl+K, B를 누릅니다.

  2. 코드 조각 관리자에서 가져오기 단추를 선택합니다.

  3. 코드 조각의 위치로 이동하여 선택하고 열기를 선택합니다.

  4. 코드 조각 가져오기 대화 상자의 오른쪽 창에서 내 코드 조각 폴더를 선택합니다. 완료를 선택한 다음 확인을 선택합니다.

    코드 조각은 코드 언어에 따라 다음 위치 중 하나에 복사됩니다.

    • %USERPROFILE%\Documents\Visual Studio 2022\Code Snippets\Visual C#\My Code 코드 조각
    • %USERPROFILE%\Documents\Visual Studio 2022\Code Snippets\Visual Basic\My Code 코드 조각
    • %USERPROFILE%\Documents\Visual Studio 2019\Code Snippets\Visual C#\My Code 코드 조각
    • %USERPROFILE%\Documents\Visual Studio 2019\Code Snippets\Visual Basic\My Code 코드 조각

  5. C# 또는 Visual Basic 프로젝트를 열어 코드 조각을 테스트합니다. 편집기에서 코드 파일을 연 상태에서 다음 작업 중 하나를 수행합니다.

    • Visual Studio 메뉴 모음에서IntelliSense>삽입 코드 조각 편집>을 선택합니다.
    • 마우스 오른쪽 단추를 클릭하고 상황에 맞는 메뉴에서 코드 조각삽입을 선택합니다>.
    • 키보드에서 CtrlK, X를 + 누릅니다.

  6. 내 코드 조각을 열고 Square Root라는 코드 조각을 두 번 클릭합니다. 코드 조각 코드가 코드 파일에 삽입됩니다.

설명 및 바로 가기 필드

설명 필드는 코드 조각 관리자에서 볼 때 코드 조각에 대한 자세한 정보를 제공합니다. 바로 가기는 코드 조각을 삽입하기 위해 입력할 수 있는 태그입니다.

  1. 코드 조각을 편집하려면 코드 언어에 따라 다음 위치 중 하나에서 코드 조각 파일을 엽니다.

    • %USERPROFILE%\Documents\Visual Studio 2022\Code Snippets\Visual C#\My Code Snippets/SquareRoot.snippet
    • %USERPROFILE%\Documents\Visual Studio 2022\Code Snippets\Visual Basic\My Code Snippets/SquareRoot.snippet
    • %USERPROFILE%\Documents\Visual Studio 2019\Code Snippets\Visual C#\My Code Snippets/SquareRoot.snippet
    • %USERPROFILE%\Documents\Visual Studio 2019\Code Snippets\Visual Basic\My Code Snippets/SquareRoot.snippet

    팁 (조언)

    Visual Studio가 배치한 디렉터리에서 파일을 편집하고 있으므로 Visual Studio에 다시 설치할 필요가 없습니다.

  2. 요소에 ShortcutHeader 요소를 Description추가하고 Author채웁니다.

  3. Header 요소가 다음 예제와 비슷한지 확인하고 파일을 저장합니다.

    <Header>
    <Title>Square Root</Title>
    <Author>Myself</Author>
    <Description>Calculates the square root of 16.</Description>
    <Shortcut>sqrt</Shortcut>
</Header>

  4. Visual Studio Code 코드 조각 관리자 를 열고 코드 조각을 선택합니다. 오른쪽 창에서 설명, 작성자 및 바로 가기 필드가 채워집니다.

    코드 조각 관리자의 코드 조각 설명을 보여 주는 스크린샷

  5. 바로 가기를 테스트하려면 이전에 사용한 프로젝트를 열고 편집기에서 sqrt 를 입력하고 Visual Basic의 경우 Tab 키를 한 번 누르고 C#에서는 두 번 누릅니다. 코드 조각 코드가 삽입됩니다.

대체 매개 변수

사용자가 코드 조각의 일부를 바꾸도록 할 수 있습니다. 예를 들어 사용자가 변수 이름을 현재 프로젝트의 변수 이름으로 바꾸도록 할 수 있습니다.

리터럴과 개체의 두 가지 대체 유형을 제공할 수 있습니다.

  • 리터럴 요소를 사용하여 코드에 삽입된 후 사용자 지정할 수 있는 코드 조각에 완전히 포함된 코드의 대체를 식별합니다. 예를 들어 문자열 또는 숫자 값입니다.

  • Object 요소를 사용하여 코드 조각에 필요하지만 코드 조각 외부에서 정의할 수 있는 항목을 식별합니다. 예를 들어 개체 인스턴스 또는 컨트롤입니다.

SquareRoot.snippet 파일의 요소를 사용하면 Literal 사용자가 숫자를 쉽게 변경하여 제곱근을 계산할 수 있습니다.

  1. SquareRoot.snippet 파일에서 다음과 같이 요소를 수정 Snippet 합니다.

    <Snippet>
  <Code Language="CSharp">
    <![CDATA[double root = Math.Sqrt($Number$);]]>
  </Code>
  <Declarations>
    <Literal>
      <ID>Number</ID>
      <ToolTip>Enter the number you want the square root of.</ToolTip>
      <Default>16</Default>
    </Literal>
  </Declarations>
</Snippet>

    리터럴 대체는 ID Number를 가져옵니다. 다음과 같이 코드 조각에서 해당 ID를 문자로 $ 둘러 둘러미하여 참조합니다.

    <![CDATA[double root = Math.Sqrt($Number$);]]>

  2. 코드 조각 파일을 저장합니다.

  3. 프로젝트를 열고 코드 조각을 삽입합니다.

    코드 조각이 삽입되고 편집 가능한 리터럴이 대체용으로 강조 표시됩니다. 대체 매개 변수를 마우스로 가리키면 값에 대한 도구 설명이 표시됩니다.

    Visual Studio의 코드 조각 대체 매개 변수 도구 설명 스크린샷

    팁 (조언)

    코드 조각에 바꿀 수 있는 매개 변수가 두 개 이상 있는 경우 Tab 키를 눌러 한 매개 변수에서 다른 매개 변수로 이동하여 값을 변경할 수 있습니다.

네임스페이스 가져오기

코드 조각을 사용하여 Imports 요소를 포함하여 지시문(C#) 또는 Imports 문(Visual Basic)을 추가할 using 수 있습니다. .NET Framework 프로젝트의 경우 References 요소를 사용하여 프로젝트에 대한 참조를 추가할 수도 있습니다.

다음 XML은 네임스페이스의 메서드 File.ExistsSystem.IO 를 사용하여 네임스페이스를 Imports 가져올 System.IO 요소를 정의하는 코드 조각을 보여 줍니다.

<?xml version="1.0" encoding="utf-8"?>
<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>File Exists</Title>
      <Shortcut>exists</Shortcut>
    </Header>
    <Snippet>
      <Code Language="CSharp">
        <![CDATA[var exists = File.Exists("C:\\Temp\\Notes.txt");]]>
      </Code>
      <Imports>
        <Import>
          <Namespace>System.IO</Namespace>
        </Import>
      </Imports>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

관련 콘텐츠

  • Last updated on