Literal 요소(IntelliSense 코드 조각)

  • 아티클

편집할 수 있는 코드 조각의 리터럴을 정의합니다.

<Literal Editable="true/false">
   <ID>... </ID>
   <ToolTip>... </ToolTip>
   <Default>... </Default>
   <Function>... </Function>
</Literal>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성

설명

Editable

선택적 Boolean 특성입니다.

코드 조각이 삽입된 후 리터럴을 편집할 수 있는지 여부를 지정합니다. 이 특성의 기본값은 true입니다.

자식 요소

요소

설명

Default

필수적 요소입니다.

코드 조각을 삽입할 때 리터럴의 기본값을 지정합니다. Literal 요소에 Default 요소가 하나만 있어야 합니다.

Function

선택적 요소입니다.

Visual Studio에서 리터럴이 포커스를 받을 때 실행할 함수를 지정합니다. Literal 요소에 Function 요소가 0개 이상 있을 수 있습니다.

ID

필수적 요소입니다.

리터럴의 고유 식별자를 지정합니다. Literal 요소에 ID 요소가 하나만 있어야 합니다.

도구 설명

선택적 요소입니다.

리터럴의 예상 값과 사용법을 설명합니다. Literal 요소에 Tooltip 요소가 0개 이상 있을 수 있습니다.

부모 요소

요소

설명

선언

편집할 수 있는 코드 조각의 리터럴과 개체가 포함되어 있습니다.

설명

Literal 요소는 코드 조각에 완전히 포함되어 있으나 코드에 삽입된 후 사용자 지정될 대체 코드 부분을 식별하는 데 사용됩니다. 예를 들어, 리터럴 문자열, 숫자 값 및 일부 변수 이름은 리터럴로 선언되어야 합니다.

리터럴과 개체는 값이 selected or end인 ID 요소를 포함할 수 없습니다. 값 $selected$는 코드 조각을 호출하면 조각으로 삽입되는 문서에서 선택한 텍스트를 나타냅니다. $end$는 코드 조각을 삽입하고 나서 커서를 놓을 위치를 표시합니다.

예제

다음 코드 예제에서는 ID 요소 값이 SQL인 리터럴을 선언하는 방법을 보여 줍니다. 이 리터럴은 기본 구분 기호를 사용하여 Code 요소에서 참조됩니다. 이 예제에서 리터럴은 $SQL$을 사용하여 참조됩니다.

<CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>Create a data adapter</Title>
            <Description>Creates a SqlDataAdapter object.</Description>
            <Author>Microsoft Corporation</Author>
            <Shortcut>createadapter</Shortcut>
        </Header>
        <Snippet>
            <Declarations>
                <Literal>
                    <ID>SQL</ID>
                    <ToolTip>Replace with a SQL connection string.</ToolTip>
                    <Default>"SQL connection string"</Default>
                </Literal>
                <Object>
                    <ID>Connection</ID>
                    <Type>System.Data.SqlClient.SqlConnection</Type>
                    <ToolTip>Replace with a connection object in your application.</ToolTip>
                    <Default>dcConnection</Default>
                </Object>
            </Declarations>
            <Code Language="CSharp">
                <![CDATA[
                    daCustomers = new SqlClient.SqlDataAdapter();
                    selectCommand = new SqlClient.SqlCommand($SQL$);
                    daCustomers.SelectCommand = selectCommand;
                    daCustomers.SelectCommand.Connection = $Connection$;
                ]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

참고 항목

개념

코드 조각 스키마 참조