코드 조각Code snippets

코드 조각은 상황에 맞는 메뉴 명령이나 바로 가기 키 조합을 사용하여 코드 파일에 삽입할 수 있는 다시 사용 가능한 작은 블록입니다.Code snippets are small blocks of reusable code that can be inserted in a code file using a context menu command or a combination of hotkeys. 일반적으로 try-finally 또는 if-else 블록과 같이 자주 사용되는 코드 블록을 포함하지만 전체 클래스나 메서드를 삽입하는 데 사용할 수 있습니다.They typically contain commonly-used code blocks such as try-finally or if-else blocks, but they can be used to insert entire classes or methods.

코드 조각은 C#, C++, Visual Basic, XML, T-SQL 등을 비롯하여 많은 언어에 대해 사용할 수 있습니다.Code snippets are available for a multitude of languages, including C#, C++, Visual Basic, XML, and T-SQL, to name a few. 언어에 대해 사용할 수있는 모든 설치된 코드 조각을 보려면 Visual Studio의 도구 메뉴에서 코드 조각 관리자를 열고 맨 위에 있는 드롭다운 메뉴에서 언어를 선택합니다.To view all the available installed snippets for a language, open the Code Snippets Manager from the Tools menu in Visual Studio, and choose the language from the drop-down menu at the top.

코드 조각 관리자 대화 상자

코드 조각은 다음과 같은 일반적인 방법으로 액세스할 수 있습니다.Code snippets can be accessed in the following general ways:

  • 메뉴 모음에서 편집 > IntelliSense > 조각 삽입...을 선택On the menu bar, choose Edit > IntelliSense > Insert Snippet...

  • 마우스 오른쪽 단추를 클릭하거나 코드 편집기의 상황에 맞는 메뉴에서 코드 조각 > 조각 삽입...을 선택From the right-click or context menu in the code editor, choose Snippet > Insert Snippet...

  • 키보드에서 Ctrl+K+X를 누름From the keyboard, press Ctrl+K+X

확장 조각 및 코드 감싸기 조각Expansion snippets and surround-with snippets

Visual Studio에는 다음 두 종류의 코드 조각이 있습니다. 확장 조각은 지정된 삽입 지점에 추가되고 조각 바로 가기를 대체할 수 있으며, 코드 감싸기 조각(C# 및 C++만 해당)은 선택한 코드 블록 주위에 추가됩니다.In Visual Studio there are two kinds of code snippet: expansion snippets, which are added at a specified insertion point and may replace a snippet shortcut, and surround-with snippets (C# and C++ only), which are added around a selected block of code.

확장 조각의 예: C#에서 바로 가기 tryf는 try-finally 블록을 삽입하는 데 사용됩니다.An example of an expansion snippet: in C# the shortcut tryf is used to insert a try-finally block:

try
{

}
finally
{

}

코드 창의 상황에 맞는 메뉴에서 조각 삽입, Visual C#를 차례로 클릭하여 이 조각을 삽입한 다음, tryf를 입력하고 나서 Tab을 누릅니다. 또는 tryf를 입력하고 Tab을 두 번 누를 수 있습니다.You can insert this snippet by clicking Insert Snippet in the context menu of the code window, then Visual C#, then type tryf, and then press Tab. Or, you can type tryf and press Tab twice.

코드 감싸기 조각의 예: C++에서 바로 가기 if는 삽입 조각 또는 코드 감싸기 조각으로 사용할 수 있습니다.An example of a surround-with snippet: in C++ the shortcut if can be used either as an insertion snippet or as a surround-with snippet. 코드 줄(예: return FALSE;)을 선택하고 코드 감싸기 > if를 선택하면 해당 줄 주위에서 조각이 확장됩니다.If you select a line of code (for example return FALSE;), and then choose Surround With > if, the snippet is expanded around the line:

if (true)
{
    return FALSE;
}

조각 대체 매개 변수Snippet replacement parameters

조각은 작성 중인 정확한 코드에 맞게 바꿔야 하는 자리 표시자인 대체 매개 변수를 포함할 수 있습니다.Snippets can contain replacement parameters, which are placeholders that you must replace to fit the precise code you are writing. 이전 예제에서 true는 적절한 조건으로 바꿀 대체 매개 변수입니다.In the previous example true is a replacement parameter, which you would replace with the appropriate condition. 조각에서 같은 매개 변수의 모든 인스턴스에 대해 반복해서 대체를 수행합니다.The replacement you make is repeated for every instance of the same replacement parameter in the snippet.

예를 들어 Visual Basic에는 속성을 삽입하는 코드 조각이 있습니다.For example, in Visual Basic there is a code snippet that inserts a property. 조각을 삽입하려면 마우스 오른쪽 단추를 클릭하거나 Visual Basic 코드 파일의 상황에 맞는 메뉴에서 조각... > 조각 삽입을 선택합니다.To insert the snippet, choose Snippet... > Insert Snippet from the right-click or context menu in a Visual Basic code file. 그런 다음, 코드 패턴 > 속성, 프로시저, 이벤트 > 속성 정의를 선택합니다.Then, choose Code Patterns > Properties, Procedures, Events > Define a Property.

속성을 정의하기 위한 코드 조각 메뉴

다음 코드가 삽입됩니다.The following code is inserted:

Private newPropertyValue As String
Public Property NewProperty() As String
    Get
        Return newPropertyValue
    End Get
    Set(ByVal value As String)
        newPropertyValue = value
    End Set
End Property

newPropertyValuem_property로 변경하면 newPropertyValue의 모든 인스턴스가 변경됩니다.If you change newPropertyValue to m_property, then every instance of newPropertyValue is changed. 속성 선언에서 StringInt로 변경하면 set 메서드의 값도 Int로 변경됩니다.If you change String to Int in the property declaration, then the value in the set method is also changed to Int.

참고 항목See also

연습: 코드 조각 만들기Walkthrough: Creating a code snippet
방법: 코드 조각 배포How to: Distribute code snippets
코드 조각 사용에 대한 모범 사례Best practices for Using code snippets
코드 조각 문제 해결Troubleshooting snippets
C# 코드 조각C# code snippets
Visual C++ 코드 조각Visual C++ code snippets
코드 조각 스키마 참조Code snippets schema reference