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

IntelliSense 코드 조각은 Visual StudioVisual Studio에서 응용 프로그램에 삽입되도록 미리 작성된 코드 부분입니다.IntelliSense Code Snippets are pre-authored pieces of code that are ready to be inserted into your application with Visual StudioVisual Studio. 코드 조각을 제공함으로써 반복 코드를 입력하거나 샘플 검색에 드는 시간을 줄여 생산성을 높일 수 있습니다.You can increase productivity by providing code snippets that reduce the amount of time spent typing repetitive code or searching for samples. IntelliSense 코드 조각 XML 스키마를 사용하여 사용자 지정 코드 조각을 만들어 Visual StudioVisual Studio에 이미 포함되어 있는 코드 조각에 추가할 수 있습니다.You can use the IntelliSense Code Snippet XML schema to create your own code snippets and add them to the code snippets that Visual StudioVisual Studio already includes.

IntelliSense 코드 조각 스키마 요소IntelliSense Code Snippets Schema Elements

Assembly 요소Assembly Element HelpUrl 요소HelpUrl Element References 요소References Element
Author 요소Author Element ID 요소ID Element Shortcut 요소Shortcut Element
Code 요소Code Element Import 요소Import Element Snippet 요소Snippet Element
CodeSnippet 요소CodeSnippet Element Imports 요소Imports Element SnippetType 요소SnippetType Element
CodeSnippets 요소CodeSnippets Element Keyword 요소Keyword Element SnippetTypes 요소SnippetTypes Element
Declarations 요소Declarations Element Keywords 요소Keywords Element Title 요소Title Element
Default 요소Default Element Literal 요소Literal Element ToolTip 요소ToolTip Element
Description 요소Description Element Namespace 요소Namespace Element Type 요소Type Element
Function 요소Function Element Object 요소Object Element Url 요소Url Element
Header 요소Header Element Reference 요소Reference Element

Assembly 요소Assembly Element

코드 조각이 참조하는 어셈블리의 이름을 지정합니다.Specifies the name of the assembly referenced by the code snippet.

Assembly 요소의 텍스트 값은 이 어셈블리의 텍스트 이름(예: System.dll)이거나 강력한 이름(예: System,Version=1.0.0.1,Culture=neutral,PublicKeyToken=9b35aa323c18d4fb1)입니다.The text value of the Assembly element is either the friendly text name of the assembly, such as System.dll, or its strong name, such as System,Version=1.0.0.1,Culture=neutral,PublicKeyToken=9b35aa323c18d4fb1.

<Assembly>  
    AssemblyName  
</Assembly>  
부모 요소Parent Element 설명Description
Reference 요소Reference Element 코드 조각에서 필요로 하는 어셈블리 참조에 대한 정보가 포함되어 있습니다.Contains information about assembly references required by the code snippet.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 코드 조각이 참조하는 어셈블리를 지정합니다.This text specifies the assembly that the code snippet references.

Author 요소Author Element

코드 조각 작성자의 이름을 지정합니다.Specifies the name of the snippet author. 코드 조각 관리자에는 코드 조각의 Author 요소에 저장된 이름이 표시됩니다.The Code Snippets Manager displays the name stored in the Author element of the code snippet.

<Author>  
   Code Snippet Author  
</Author>    
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보가 포함되어 있습니다.Contains general information about the code snippet.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 코드 조각의 작성자를 지정합니다.This text specifies the author of the code snippet.

Code 요소 Code Element

짧은 코드 블록에 대한 컨테이너를 제공합니다.Provides a container for short code blocks.

키워드Keywords

Code 요소의 텍스트에는 $end$$selected$의 두 예약어를 사용할 수 있습니다.Two reserved words are available for use in the text of the Code element: $end$ and $selected$. $end$는 코드 조각을 삽입하고 나서 커서를 놓을 위치를 표시합니다.$end$ marks the location to place the cursor after the code snippet is inserted. $selected$는 코드 조각을 호출하면 조각으로 삽입되는 문서에서 선택한 텍스트를 나타냅니다.$selected$ represents text selected in the document that is to be inserted into the snippet when it is invoked. 다음을 포함하는 코드 조각의 예를 들어 보겠습니다.For example, given a snippet that includes:

$selected$ is a great color.  

사용자가 템플릿을 호출할 때 "Blue"라는 단어를 선택하면 결과는 다음과 같이 표시됩니다.If the word "Blue" is selected when the user invokes the template, the result is:

Blue is a great color.  

$end$ 또는 $selected$를 코드 조각 하나에서 두 번 이상 사용할 수는 없습니다.You may not use either $end$ or $selected$ more than once in a code snippet. 이렇게 하면 두 번째 인스턴스만 인식됩니다.If you do, only the second instance is recognized. 이번에는 다음을 포함하는 코드 조각을 살펴보겠습니다.Given a snippet that includes:

$selected$ is a great color. I love $selected$.  

여기서는 "Blue"라는 단어를 선택하면 결과가 다음과 같이 표시됩니다.If the word "Blue" is selected, the result is:

 is a great color. I love Blue.  

$selected$is 사이에 공백이 있기 때문에 첫 번째 항목은 공백으로 표시됩니다.The initial space appears because there is a space between $selected$ and is.

다른 모든 $ 키워드는 <Literal><Object> 태그에서 동적으로 정의됩니다.All other $ keywords are dynamically defined in the <Literal> and <Object> tags.

코드 요소의 구조는 다음과 같습니다.Following is the structure of the Code element:

<Code Language="Language"  
    Kind="method body/method decl/type decl/page/file/any"  
    Delimiter="Delimiter">  
    Code to insert  
</Code>  

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 이 코드 조각이 코드 파일에 삽입될 때 사용할 수 있는 코드를 리터럴 및 개체와 함께 지정합니다.This text specifies the code, along with the literals and objects, that you can use when this code snippet is inserted into a code file.

특성Attributes

코드 요소에 세 가지 특성을 사용할 수 있습니다.There are three attributes available for the Code element:

  • 코드 조각의 언어를 지정하는 언어 - 필수 특성입니다.Language - Required attribute that specifies the language of the code snippet. 값은 다음 중 하나일 수 있습니다.The value can be one of the following:

    Value 설명Description
    VB Visual Basic 코드 조각을 식별합니다.Identifies a Visual Basic code snippet.
    CSharp C# 코드 조각을 식별합니다.Identifies a C# code snippet.
    CPP C++ 코드 조각을 식별합니다.Identifies a C++ code snippet.
    XML XML 코드 조각을 식별합니다.Identifies an XML code snippet.
    JavaScript JavaScript 코드 조각을 식별합니다.Identifies a JavaScript code snippet.
    SQL SQL 코드 조각을 식별합니다.Identifies a SQL code snippet.
    HTML HTML 코드 조각을 식별합니다.Identifies an HTML code snippet.
  • 코드 조각에 포함되는 코드 종류를 지정하고 코드 조각 컴파일을 위해 해당 코드 조각을 삽입해야 하는 위치를 지정하는 종류 - 선택 사항 특성입니다.Kind - Optional attribute that specifies the kind of code that the snippet contains, and the location at which a code snippet must be inserted for the code snippet to compile. 값은 다음 중 하나일 수 있습니다.The value can be one of the following:

    Value 설명Description
    method body 코드 조각이 메서드 본문이므로 메서드 선언 안에 삽입되도록 지정합니다.Specifies that the code snippet is a method body, and therefore, must be inserted inside a method declaration.
    method decl 코드 조각이 메서드이므로 클래스나 모듈 안에 삽입되도록 지정합니다.Specifies that the code snippet is a method, and therefore, must be inserted inside a class or module.
    type decl 코드 조각이 형식이므로 클래스, 모듈 또는 네임스페이스 안에 삽입되도록 지정합니다.Specifies that the code snippet is a type, and therefore, must be inserted inside a class, module, or namespace.
    file 코드 조각이 완전한 코드 파일임을 지정합니다.Specifies that the snippet is a full code file. 이러한 코드 조각은 코드 파일이나 네임스페이스 안에 단독으로 삽입될 수 있습니다.These code snippets can be inserted alone into a code file, or inside a namespace.
    any 코드 조각이 어디든지 삽입될 수 있도록 지정합니다.Specifies that the snippet can be inserted anywhere. 이 태그는 주석과 같이 컨텍스트와 상관없는 코드 조각에 사용됩니다.This tag is used for code snippets that are context-independent, such as comments.
  • 코드의 리터럴 및 개체를 설명하는 데 사용되는 구분 기호를 지정하는 구분 기호 - 선택 사항 특성입니다.Delimiter - Optional attribute that specifies the delimiter used to describe literals and objects in the code. 기본값으로 사용되는 구분 기호는 $입니다.By default, the delimiter is $.

부모 요소Parent element

부모 요소Parent Element 설명Description
Snippet 요소Snippet Element 코드 조각에 대한 참조, 가져오기, 선언 및 코드가 포함되어 있습니다.Contains the references, imports, declarations, and code for the code snippet.

CodeSnippet 요소CodeSnippet Element

Visual Studio Code 파일에 삽입할 수 있는 여러 IntelliSense 코드 조각 및 제목을 지정할 수 있습니다.Allows you to specify a heading and multiple IntelliSense Code Snippets, which you can insert into Visual Studio code files.

<CodeSnippet Format="x.x.x">  
    <Header>... </Header>  
    <Snippet>... </Snippet>  
</CodeSnippet>  
특성Attribute 설명Description
Format 필수 특성입니다.Required attribute. 코드 조각의 스키마 버전을 지정합니다.Specifies the schema version of the code snippet. Format 특성은 x.x.x 구문의 문자열이어야 합니다. 여기서 각 "x"는 버전 번호의 숫자 값을 나타냅니다.The Format attribute must be a string in the syntax of x.x.x, where each "x" represents a numerical value of the version number. Visual Studio에서는 이해할 수 없는 Format 특성을 갖는 코드 조각을 무시합니다.Visual Studio will ignore code snippets with Format attributes that it does not understand.
자식 요소Child Element 설명Description
Header 요소Header Element 필수적 요소입니다.Required element. 코드 조각에 대한 일반 정보가 포함되어 있습니다.Contains general information about the code snippet. 하나의 코드 조각에는 Header 요소가 단 하나만 있어야 합니다.There must be exactly one Header element in a code snippet.
Snippet 요소Snippet Element 필수적 요소입니다.Required element. Visual Studio에서 삽입할 코드가 포함되어 있습니다.Contains the code that will be inserted by Visual Studio. 하나의 코드 조각에는 Snippet 요소가 단 하나만 있어야 합니다.There must be exactly one Snippet element in a code snippet.
부모 요소Parent Element 설명Description
CodeSnippets 요소CodeSnippets Element 코드 조각 XML 스키마의 루트 요소입니다.Root element of the code snippet XML schema.

CodeSnippets 요소CodeSnippets Element

CodeSnippet 요소를 그룹화합니다.Groups CodeSnippet Elementelements. CodeSnippets 요소는 코드 조각 XML 스키마의 루트 요소입니다.The CodeSnippets element is the root element of the code snippet XML schema.

<CodeSnippets>  
    <CodeSnippet>... </CodeSnippet>  
</CodeSnippets>  
자식 요소Child Element 설명Description
CodeSnippet 요소CodeSnippet Element 선택적 요소입니다.Optional element. 모든 코드 조각 데이터의 부모 요소입니다.Parent element for all code snippet data. CodeSnippet 요소에는 CodeSnippets 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more CodeSnippet elements in a CodeSnippets element.

Declarations 요소Declarations Element

코드 조각에서 편집할 수 있는 부분을 구성하는 리터럴과 개체를 지정합니다.Specifies the literals and objects that make up the parts of a code snippet that you can edit.

<Declarations>  
    <Literal>... </Literal>  
    <Object>... </Object>  
</Declarations>  
자식 요소Child Element 설명Description
Literal 요소Literal Element 선택적 요소입니다.Optional element. 편집할 수 있는 코드 조각의 리터럴을 정의합니다.Defines the literals of the code snippet that you can edit. Literal 요소에는 Declarations 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more Literal elements in a Declarations element.
Object 요소Object Element 선택적 요소입니다.Optional element. 편집할 수 있는 코드 조각의 개체를 정의합니다.Defines the objects of the code snippet that you can edit. Object 요소에는 Declarations 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more Object elements in a Declarations element.
부모 요소Parent Element 설명Description
Snippet 요소Snippet Element 코드 조각에 대한 참조, 가져오기, 선언 및 코드가 포함되어 있습니다.Contains the references, imports, declarations, and code for the code snippet.

Default 요소Default Element

IntelliSense 코드 조각의 리터럴 또는 개체에 대한 기본값을 지정합니다.Specifies the default value of the literal or object for an IntelliSense Code Snippet.

<Default>  
    Default value  
</Default>  
부모 요소Parent Element 설명Description
Literal 요소Literal Element 편집할 수 있는 코드 조각의 리터럴 필드를 정의합니다.Defines the literal fields of the code snippet that you can edit.
Object 요소Object Element 편집할 수 있는 코드 조각의 개체 필드를 정의합니다.Defines the object fields of the code snippet that you can edit.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 편집할 수 있는 코드 조각의 필드를 채우는 리터럴 또는 개체의 기본값을 지정합니다.This text specifies the default value of the literal or object that fills the fields of the code snippet that you can edit.

Description 요소Description Element

IntelliSense 코드 조각의 콘텐츠에 대한 설명 정보를 지정합니다.Specifies descriptive information about the contents of an IntelliSense Code Snippet.

<Description>  
    Code Snippet Description  
</Description>  
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보가 포함되어 있습니다.Contains general information about the code snippet.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 코드 조각을 설명합니다.This text describes the code snippet.

Function 요소Function Element

Visual Studio에서 리터럴 또는 개체가 포커스를 받을 때 실행할 함수를 지정합니다.Specifies a function to execute when the literal or object receives focus in Visual Studio.

참고

Function 요소는 Visual C# 코드 조각에서만 지원됩니다.The Function element is only supported in Visual C# code snippets.

<Function>  
    FunctionName  
</Function>  
부모 요소Parent Element 설명Description
Literal 요소Literal Element 편집할 수 있는 코드 조각의 리터럴 필드를 정의합니다.Defines the literal fields of the code snippet that you can edit.
Object 요소Object Element 편집할 수 있는 코드 조각의 개체 필드를 정의합니다.Defines the object fields of the code snippet that you can edit.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 Visual Studio에서 리터럴 또는 개체 필드가 포커스를 받을 때 실행할 함수를 지정합니다.This text specifies a function to execute when the literal or object field receives focus in Visual Studio.

IntelliSense 코드 조각에 대한 일반 정보를 지정합니다.Specifies general information about the IntelliSense Code Snippet.

<Header>  
    <Title>... </Title>  
    <Author>... </Author>  
    <Description>... </Description>  
    <HelpUrl>... </HelpUrl>  
    <SnippetTypes>... </SnippetTypes>  
    <Keywords>... </Keywords>  
    <Shortcut>... </Shortcut>  
</Header>  
자식 요소Child Element 설명Description
Author 요소Author Element 선택적 요소입니다.Optional element. 코드 조각을 작성한 사람 또는 회사의 이름입니다.The name of the person or company that authored the code snippet. Author 요소에는 Header 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Author elements in a Header element.
Description 요소Description Element 선택적 요소입니다.Optional element. 코드 조각에 대한 설명입니다.A description of the code snippet. Description 요소에는 Header 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Description elements in a Header element.
HelpUrl 요소HelpUrl Element 선택적 요소입니다.Optional element. 코드 조각에 대한 추가 정보가 들어 있는 URL입니다.A URL that contains more information about the code snippet. Header 요소에는 HelpURL 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one HelpURL elements in a Header element. 참고: Visual Studio에서는 HelpUrl 요소를 사용하지 않습니다.Note: Visual Studio does not use the HelpUrl element. 이 요소는 IntelliSense 코드 조각 XML 스키마의 일부이며 이 요소를 포함하는 모든 코드 조각의 유효성이 검사되지만 요소의 값은 사용되지 않습니다.The element is part of the IntelliSense Code Snippet XML schema and any code snippet containing the element will validate, but the value of the element is never used.
Keywords 요소Keywords Element 선택적 요소입니다.Optional element. Keyword 요소를 그룹화합니다.Groups Keyword elements. Keywords 요소에는 Header 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Keywords elements in a Header element.
Shortcut 요소Shortcut Element 선택적 요소입니다.Optional element. 코드 조각을 삽입하는 데 사용할 수 있는 바로 가기 텍스트를 지정합니다.Specifies the shortcut text that can be used to insert the snippet. Shortcut 요소에는 Header 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Shortcut elements in a Header element.
SnippetTypes 요소SnippetTypes Element 선택적 요소입니다.Optional element. SnippetType 요소를 그룹화합니다.Groups SnippetType elements. SnippetTypes 요소에는 Header 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one SnippetTypes elements in a Header element. SnippetTypes 요소가 없으면 코드 조각은 항상 유효합니다.If there are no SnippetTypes elements, the code snippet is always valid.
Title 요소Title Element 필수적 요소입니다.Required element. 코드 조각의 이름입니다.The friendly name of the code snippet. 하나의 Title 요소에는 Header 요소가 단 하나만 있어야 합니다.There must be exactly one Title element in a Header element.
부모 요소Parent Element 설명Description
CodeSnippet 요소CodeSnippet Element 모든 코드 조각 데이터의 부모 요소입니다.Parent element for all code snippet data.

HelpUrl 요소HelpUrl Element

코드 조각에 대한 자세한 정보를 제공하는 URL을 지정합니다.Specifies a URL that provides more information about a code snippet.

참고

Visual Studio에서는 HelpUrl 요소를 사용하지 않습니다.Visual Studio does not use the HelpUrl element. 이 요소는 IntelliSense 코드 조각 XML 스키마의 일부이며 이 요소를 포함하는 모든 코드 조각의 유효성이 검사되지만 요소의 값은 사용되지 않습니다.The element is part of the IntelliSense Code Snippet XML schema and any code snippet containing the element will validate, but the value of the element is never used.

<HelpUrl>  
    www.microsoft.com  
</HelpUrl>  
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보가 포함되어 있습니다.Contains general information about the code snippet.

텍스트 값은 선택적입니다.A text value is optional. 이 텍스트는 코드 조각에 대한 추가 정보를 얻기 위해 방문할 URL을 지정합니다.This text specifies the URL to visit for more information about a code snippet.

ID 요소ID Element

Literal 또는 Object 요소에 대한 고유 식별자를 지정합니다.Specifies a unique identifier for a Literal or Object element. 같은 코드 조각에서 두 개의 리터럴 또는 개체는 해당 ID 요소에 같은 텍스트 값을 가질 수 없습니다. 리터럴과 개체는 end 값을 가진 ID 요소를 포함할 수 없습니다.No two literals or objects in the same code snippet can have the same text value in their ID elements.Literals and objects cannot contain an ID element with a value of end. $end$ 값은 예약되어 있으며, 코드 조각을 삽입하고 나서 커서를 놓을 위치를 표시하는 데 사용됩니다.The value $end$ is reserved, and is used to mark the location to place the cursor after the code snippet is inserted.

<ID>  
    Unique Identifier  
</ID>  
부모 요소Parent Element 설명Description
Literal 요소Literal Element 편집할 수 있는 코드 조각의 리터럴 필드를 정의합니다.Defines the literal fields of the code snippet that you can edit.
Object 요소Object Element 편집할 수 있는 코드 조각의 개체 필드를 정의합니다.Defines the object fields of the code snippet that you can edit.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 개체 또는 리터럴의 고유 식별자를 지정합니다.This text specifies the unique identifier for the object or literal.

Import 요소Import Element

IntelliSense 코드 조각에서 사용되는 가져온 네임스페이스를 지정합니다.Specifies the imported namespaces used by an IntelliSense Code Snippet.

참고

Import 요소는 Visual Basic 프로젝트에서만 지원됩니다.The Import element is only supported for Visual Basic projects.

<Import>  
    <Namespace>... </Namespace>  
</Import>  
자식 요소Child Element 설명Description
Namespace 요소Namespace Element 필수적 요소입니다.Required element. 코드 조각에서 사용되는 네임스페이스를 지정합니다.Specifies the namespace used by the code snippet. 하나의 Namespace 요소에는 Import 요소가 단 하나만 있어야 합니다.There must be exactly one Namespace element in an Import element.
부모 요소Parent Element 설명Description
Imports 요소Imports Element Import 요소에 대한 grouping 요소입니다.Grouping element for Import elements.

Imports 요소Imports Element

개별 Import 요소를 그룹화합니다.Groups individual Import elements.

참고

Imports 요소는 Visual Basic 프로젝트에서만 지원됩니다.The Imports element is only supported for Visual Basic projects.

<Imports>  
    <Import>... </Import>  
<Imports>  
자식 요소Child Element 설명Description
Import 요소Import Element 선택적 요소입니다.Optional element. 코드 조각에 대해 가져온 네임스페이스가 포함되어 있습니다.Contains the imported namespaces for the code snippet. Imports 요소에는 Import 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more Import elements in an Imports element.
부모 요소Parent Element 설명Description
Snippet 요소Snippet Element 코드 조각에 대한 참조, 가져오기, 선언 및 코드가 포함되어 있습니다.Contains the references, imports, declarations, and code for the code snippet.

Keyword 요소Keyword Element

코드 조각에 대한 사용자 지정 키워드를 지정합니다.Specifies a custom keyword for the code snippet. Visual Studio에서 코드 조각 키워드는 온라인 콘텐츠 공급자가 검색 또는 분류용으로 사용자 지정 키워드를 추가하기 위한 표준 방법을 나타내는 데 사용됩니다.The code snippet keywords are used by Visual Studio and represent a standard way for online content providers to add custom keywords for searching or categorization.

<Keyword>  
    Code Snippet Keyword  
</Keyword>  
부모 요소Parent Element 설명Description
Keywords 요소Keywords Element 개별 Keyword 요소를 그룹화합니다.Groups individual Keyword elements.

텍스트 값은 필수입니다.A text value is required. 코드 조각에 대한 키워드입니다.The keyword for the code snippet.

Keywords 요소Keywords Element

개별 Keyword 요소를 그룹화합니다.Groups individual Keyword elements. Visual Studio에서 코드 조각 키워드는 온라인 콘텐츠 공급자가 검색 또는 분류용으로 사용자 지정 키워드를 추가하기 위한 표준 방법을 나타내는 데 사용됩니다.The code snippet keywords are used by Visual Studio and represent a standard way for online content providers to add custom keywords for searching or categorization

<Keywords>  
    <Keyword>... </Keyword>  
    <Keyword>... </Keyword>  
<Keywords>  
자식 요소Child Element 설명Description
Keyword 요소Keyword Element 선택적 요소입니다.Optional element. 코드 조각에 대한 개별 키워드가 포함되어 있습니다.Contains individual keywords for the code snippet. Keyword 요소에는 Keywords 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more Keyword elements in a Keywords element.
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보가 포함되어 있습니다.Contains general information about the code snippet.

Literal 요소Literal Element

편집할 수 있는 코드 조각의 리터럴을 정의합니다.Defines the literals of the code snippet that you can edit. Literal 요소는 코드 조각에 완전히 포함되어 있으나 코드에 삽입된 후 사용자 지정될 대체 코드 부분을 식별하는 데 사용됩니다.The Literal element is used to identify a replacement for a piece of code that is entirely contained within the snippet, but will likely be customized after it is inserted into the code. 예를 들어, 리터럴 문자열, 숫자 값 및 일부 변수 이름은 리터럴로 선언해야 합니다.For example, literal strings, numeric values, and some variable names should be declared as literals.

리터럴과 개체는 selected 또는 end 값인 ID 요소를 포함할 수 없습니다.Literals and objects cannot contain an ID element with a value of selected or end. $selected$는 코드 조각을 호출하면 조각으로 삽입되는 문서에서 선택한 텍스트를 나타냅니다.The value $selected$ represents text selected in the document that is to be inserted into the snippet when it is invoked. $end$는 코드 조각을 삽입하고 나서 커서를 놓을 위치를 표시합니다.$end$ marks the location to place the cursor after the code snippet is inserted.

<Literal Editable="true/false">  
   <ID>... </ID>  
   <ToolTip>... </ToolTip>  
   <Default>... </Default>  
   <Function>... </Function>  
</Literal>  
특성Attribute 설명Description
Editable 선택적 Boolean 특성입니다.Optional Boolean attribute. 코드 조각을 삽입한 이후에 리터럴을 편집할 수 있는지 여부를 지정합니다.Specifies whether or not you can edit the literal after the code snippet is inserted. 이 특성의 기본값은 true입니다.The default value of this attribute is true.
자식 요소Child Element 설명Description
Default 요소Default Element 필수적 요소입니다.Required element. 코드 조각을 삽입할 때 리터럴의 기본값을 지정합니다.Specifies the literal's default value when you insert the code snippet. 하나의 Default 요소에는 Literal 요소가 단 하나만 있어야 합니다.There must be exactly one Default element in a Literal element.
Function 요소Function Element 선택적 요소입니다.Optional element. Visual Studio에서 리터럴이 포커스를 받을 때 실행할 함수를 지정합니다.Specifies a function to execute when the literal receives focus in Visual Studio. Function 요소에는 Literal 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Function elements in a Literal element.
ID 요소ID Element 필수적 요소입니다.Required element. 리터럴의 고유 식별자를 지정합니다.Specifies a unique identifier for the literal. 하나의 ID 요소에는 Literal 요소가 단 하나만 있어야 합니다.There must be exactly one ID element in a Literal element.
ToolTip 요소ToolTip Element 선택적 요소입니다.Optional element. 리터럴의 예상 값과 사용법을 설명합니다.Describes the expected value and usage of the literal. Literal 요소에는 Tooltip 요소가 0개 또는 1개 있을 수 있습니다.There may be zero or one Tooltip elements in a Literal element.
부모 요소Parent Element 설명Description
Declarations 요소Declarations Element 편집할 수 있는 코드 조각의 리터럴과 개체가 포함되어 있습니다.Contains the literals and objects of a code snippet that you can edit.

Namespace 요소Namespace Element

코드 조각이 컴파일 및 실행될 수 있도록 가져와야 하는 네임스페이스를 지정합니다.Specifies the namespace that must be imported for the code snippet to compile and run. Namespace 요소에 지정된 네임스페이스가 아직 없는 경우 코드의 시작 부분에 있는 Imports 문에 자동으로 추가됩니다.The namespace specified in the Namespace element is automatically added to an Imports statement at the beginning of the code, if it does not already exist.

참고

Namespace 요소는 Visual Basic 프로젝트에서만 지원됩니다.The Namespace element is only supported for Visual Basic projects.

<Namespace>  
    Namespace  
</Namespace>  
부모 요소Parent Element 설명Description
Import 요소Import Element 지정된 네임스페이스를 가져옵니다.Imports the specified namespace.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 코드 조각이 가정하는 네임스페이스를 가져오도록 지정합니다.This text specifies a namespace that the code snippet assumes is imported.

Object 요소Object Element

편집할 수 있는 코드 조각의 개체를 정의합니다.Defines the objects of the code snippet that you can edit. Object 요소는 코드 조각에서 필요하지만 코드 조각 자체의 외부에서 정의될 항목을 식별하는 데 사용됩니다.The Object element is used to identify an item that is required by the code snippet but is likely to be defined outside of the snippet itself. 예를 들어, Windows Forms 컨트롤, ASP.NET 컨트롤, 개체 인스턴스 및 형식 인스턴스는 개체로 선언되어야 합니다.For example, Windows Forms controls, ASP.NET controls, object instances, and type instances should be declared as objects. 개체 선언에는 형식이 지정되어야 하며, 이 형식은 Type 요소를 사용하여 지정합니다.Object declarations require that a type be specified, which is done with the Type element.

<Object Editable="true/false">  
    <ID>... </ID>  
    <Type>... </Type>  
    <ToolTip>... </ToolTip>  
    <Default>... </Default>  
    <Function>... </Function>  
</Object>  
특성Attribute 설명Description
Editable 선택적 Boolean 특성입니다.Optional Boolean attribute. 코드 조각을 삽입한 이후에 리터럴을 편집할 수 있는지 여부를 지정합니다.Specifies whether or not you can edit the literal after the code snippet is inserted. 이 특성의 기본값은 true입니다.The default value of this attribute is true.
자식 요소Child Element 설명Description
Default 요소Default Element 필수적 요소입니다.Required element. 코드 조각을 삽입할 때 리터럴의 기본값을 지정합니다.Specifies the literal's default value when you insert the code snippet. 하나의 Default 요소에는 Literal 요소가 단 하나만 있어야 합니다.There must be exactly one Default element in a Literal element.
Function 요소Function Element 선택적 요소입니다.Optional element. Visual Studio에서 리터럴이 포커스를 받을 때 실행할 함수를 지정합니다.Specifies a function to execute when the literal receives focus in Visual Studio. Function 요소에는 Literal 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Function elements in a Literal element.
ID 요소ID Element 필수적 요소입니다.Required element. 리터럴의 고유 식별자를 지정합니다.Specifies a unique identifier for the literal. 하나의 ID 요소에는 Literal 요소가 단 하나만 있어야 합니다.There must be exactly one ID element in a Literal element.
ToolTip 요소ToolTip Element 선택적 요소입니다.Optional element. 리터럴의 예상 값과 사용법을 설명합니다.Describes the expected value and usage of the literal. Literal 요소에는 Tooltip 요소가 0개 또는 1개 있을 수 있습니다.There may be zero or one Tooltip elements in a Literal element.
Type 요소Type Element 필수적 요소입니다.Required element. 개체의 형식을 지정합니다.Specifies the type of the object. 하나의 Type 요소에는 Object 요소가 단 하나만 있어야 합니다.There must be exactly one Type element in an Object element.
부모 요소Parent Element 설명Description
Declarations 요소Declarations Element 편집할 수 있는 코드 조각의 리터럴과 개체가 포함되어 있습니다.Contains the literals and objects of a code snippet that you can edit.

Reference 요소Reference Element

코드 조각에 필요한 어셈블리 참조에 대한 정보를 지정합니다.Specifies information about the assembly references required by the code snippet.

<Reference>  
    <Assembly>... </Assembly>  
    <Url>... </Url>  
</Reference>  
자식 요소Child Element 설명Description
Assembly 요소Assembly Element 필수적 요소입니다.Required element. 코드 조각이 참조하는 어셈블리 이름이 포함되어 있습니다.Contains the name of the assembly referenced by the code snippet. 하나의 Assembly 요소에는 Reference 요소가 단 하나만 있어야 합니다.There must be exactly one Assembly element in a Reference element.
Url 요소Url Element 선택적 요소입니다.Optional element. 참조된 어셈블리에 대한 추가 정보를 제공하는 URL이 포함되어 있습니다.Contains a URL that provides more information about the referenced assembly. Url 요소에는 Reference 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Url elements in a Reference element.
부모 요소Parent Element 설명Description
References 요소References Element Reference 요소에 대한 그룹화 요소입니다.Grouping element for Reference elements.

References 요소References Element

개별 Reference 요소를 그룹화합니다.Groups individual Reference elements.

<References>  
    <Reference>... </Reference>  
</References>  
자식 요소Child Element 설명Description
Reference 요소Reference Element 선택적 요소입니다.Optional element. 코드 조각의 어셈블리 참조에 대한 정보가 포함되어 있습니다.Contains information about assembly references for the code snippet. Reference 요소에는 References 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more Reference elements in a References element.
부모 요소Parent Element 설명Description
Snippet 요소Snippet Element 코드 조각에 대한 참조, 가져오기, 선언 및 코드가 포함되어 있습니다.Contains the references, imports, declarations, and code for the code snippet.

Shortcut 요소Shortcut Element

조각을 삽입하는 데 사용되는 바로 가기 텍스트를 지정합니다.Specifies the shortcut text used to insert the snippet. Shortcut 요소의 텍스트 값에는 영숫자, 하이픈(-) 및 밑줄()만 포함될 수 있습니다.The text value of a Shortcut element can only contain alphanumeric characters, hyphens ( - ), and underscores ( ).

주의

C++에서는 코드 조각 바로 가기에 및 – 문자를 지원하지 않습니다. and - are not supported characters in C++ snippet shortcuts.

<Shortcut>  
    Shortcut Text  
</Shortcut>  
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보가 포함되어 있습니다.Contains general information about the code snippet.

텍스트 값은 선택적입니다.A text value is optional. 이 텍스트는 코드 조각을 삽입하기 위한 바로 가기로 사용됩니다.This text is used as a shortcut for inserting the code snippet.

Snippet 요소Snippet Element

코드 조각의 참조, 가져오기, 선언 및 코드를 지정합니다.Specifies the references, imports, declarations, and code for the code snippet.

<Snippet>  
    <References>... </References>  
    <Imports>... </Imports>  
    <Declarations>... </Declarations>  
    <Code>... </Code>  
</Snippet>    
자식 요소Child Element 설명Description
Code 요소Code Element 필수적 요소입니다.Required element. 설명서 파일에 삽입할 코드를 지정합니다.Specifies the code that you want to insert into a documentation file. 하나의 Code 요소에는 Snippet 요소가 단 하나만 있어야 합니다.There must be exactly one Code element in a Snippet element.
Declarations 요소Declarations Element 선택적 요소입니다.Optional element. 코드 조각에서 편집할 수 있는 부분을 구성하는 리터럴과 개체를 지정합니다.Specifies the literals and objects that make up the parts of a code snippet that you can edit. Declarations 요소에는 Snippet 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Declarations elements in a Snippet element.
Imports 요소Imports Element 선택적 요소입니다.Optional element. 개별 Import 요소를 그룹화합니다.Groups individual Import elements. Imports 요소에는 Snippet 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one Imports elements in a Snippet element.
선택적 요소입니다.Optional element. 개별 Reference 요소를 그룹화합니다.Groups individual Reference elements. References 요소에는 Snippet 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or one References elements in a Snippet element.
부모 요소Parent Element 설명Description
CodeSnippet 요소CodeSnippet Element Visual Studio Code 파일에 삽입할 수 있는 여러 IntelliSense 코드 조각 및 제목을 지정할 수 있습니다.Allows you to specify a heading and multiple IntelliSense Code Snippets, which you can insert into Visual Studio code files.

SnippetType 요소SnippetType Element

Visual Studio에서 코드 조각을 삽입하는 방법을 지정합니다.Specifies how Visual Studio inserts the code snippet.

<SnippetType>  
    SurroundsWith/Expansion  
<SnippetType>  
부모 요소Parent Element 설명Description
SnippetTypes 요소SnippetTypes Element SnippetType 요소를 그룹화합니다.Groups SnippetType elements.

텍스트 값은 다음 값 중 하나여야 합니다.The text value must be one of the following values:

  • SurroundsWith: 코드 조각을 선택된 코드 부분 주위에 배치할 수 있습니다.SurroundsWith: allows the code snippet to be placed around a selected piece of code.

  • Expansion: 코드 조각을 커서 위치에 삽입할 수 있습니다.Expansion: allows the code snippet to be inserted at the cursor.

  • Refactoring: Visual C# 리팩터링 동안 코드 조각이 사용되도록 지정합니다.Refactoring: specifies that the code snippet is used during Visual C# refactoring. 사용자 지정 코드 조각에서는 Refactoring을 사용할 수 없습니다.Refactoring cannot be used in custom code snippets.

SnippetTypes 요소SnippetTypes Element

개별 SnippetType 요소를 그룹화합니다.Groups individual SnippetType elements. SnippetTypes 요소가 없으면 코드에서 임의의 위치에 코드 조각을 삽입할 수 있습니다.If the SnippetTypes element is not present, the code snippet can be inserted anywhere in the code.

<SnippetTypes>  
    <SnippetType>... </SnippetType>  
    <SnippetType>... </SnippetType>  
<SnippetTypes>  
자식 요소Child Element 설명Description
SnippetType 요소SnippetType Element 선택적 요소입니다.Optional element. Visual Studio에서 코드에 코드 조각을 삽입하는 방법을 지정합니다.Specifies how Visual Studio inserts the code snippet into the code. SnippetType 요소에는 SnippetTypes 요소가 0개 또는 그 이상 있을 수 있습니다.There may be zero or more SnippetType elements in a SnippetTypes element.
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보를 지정합니다.Specifies general information about the code snippet.

Title 요소Title Element

코드 조각의 제목을 지정합니다.Specifies the title for the code snippet. 코드 조각의 Title 요소에 저장된 제목은 코드 조각 선택코드 조각 관리자의 코드 조각 설명에 표시됩니다.The title stored in the Title element of the code snippet appears in the Code Snippet Picker and in the code snippet's description in the Code Snippets Manager.

<Title>  
    Code Snippet Title  
<Title>  
부모 요소Parent Element 설명Description
Header 요소Header Element 코드 조각에 대한 일반 정보를 지정합니다.Specifies general information about the code snippet.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 코드 조각의 제목을 지정합니다.This text specifies the title of the code snippet.

ToolTip 요소ToolTip Element

코드 조각에 있는 리터럴 또는 개체의 예상 값 및 사용법을 설명합니다. 이 값은 Visual Studio에서 코드 조각을 프로젝트에 삽입할 때 도구 설명에 표시됩니다.Describes the expected value and usage of a literal or object in a code snippet, which Visual Studio displays in a ToolTip when it inserts the code snippet into a project. 코드 조각을 삽입하고 나서 마우스를 리터럴이나 개체 위로 가져가면 도구 설명 텍스트가 표시됩니다.The ToolTip text is displayed when the mouse hovers over the literal or object after the code snippet has been inserted.

<ToolTip>  
    ToolTip description  
</ToolTip>  
부모 요소Parent Element 설명Description
Literal 요소Literal Element 편집할 수 있는 코드 조각의 리터럴 필드를 정의합니다.Defines the literal fields of the code snippet that you can edit.
Object 요소Object Element 편집할 수 있는 코드 조각의 개체 필드를 정의합니다.Defines the object fields of the code snippet that you can edit.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 코드 조각에 있는 개체나 리터럴과 관련된 도구 설명을 지정합니다.This text specifies the ToolTip description to be associated with the object or literal in the code snippet.

Type 요소Type Element

개체의 형식을 지정합니다.Specifies the type of the object. Object 요소는 코드 조각에서 필요하지만 코드 조각 자체의 외부에서 정의될 항목을 식별하는 데 사용됩니다.The Object element is used to identify an item that is required by the code snippet but is likely to be defined outside of the snippet itself. 예를 들어, Windows Forms 컨트롤, ASP.NET 컨트롤, 개체 인스턴스 및 형식 인스턴스는 개체로 선언되어야 합니다.For example, Windows Forms controls, ASP.NET controls, object instances, and type instances should be declared as objects. 개체 선언에는 형식이 지정되어야 하며, 이 형식은 Type 요소를 사용하여 지정합니다.Object declarations require that a type be specified, which is done with the Type element.

<Type>  
    Type  
</Type>  
부모 요소Parent Element 설명Description
Object 요소Object Element 편집할 수 있는 코드 조각의 개체 필드를 정의합니다.Defines the object fields of the code snippet that you can edit.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 개체의 형식을 지정합니다.This text specifies the type of the object.

Url 요소Url Element

참조된 어셈블리에 대한 자세한 정보를 제공하는 URL을 지정합니다.Specifies a URL that provides more information about the referenced assembly.

참고

Url 요소는 Visual Basic 프로젝트에서만 지원됩니다.The Url element is only supported for Visual Basic projects.

<Url>  
    www.microsoft.com  
</Url>  
부모 요소Parent Element 설명Description
Reference 요소Reference Element 코드 조각에 필요한 어셈블리 참조를 지정합니다.Specifies the assembly references required by the code snippet.

텍스트 값은 필수입니다.A text value is required. 이 텍스트는 참조된 어셈블리에 대한 추가 정보를 제공하는 URL을 지정합니다.This text specifies a URL with more information about the referenced assembly. 참조가 프로젝트에 추가될 수 없는 경우 이 URL이 표시됩니다.This URL is displayed when the reference cannot be added to the project.

참고 항목See Also

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